The Brown 


U niversity 


Gra phics 


S ystem 1 


META 4 


B / SIMALE / VECTOR GENERAL 


Concepts and facilities 
Paul Constantine A nagnostopoulos 
Harold Henry Webber, Jr. 

John Zahorjan 


The Brown University Graphics Project 
Division of Applied Mathematics 
Box F 

Brown University 
Providence, Rhode Island 02912 


Updated: January 12,1976 
Printed: December 6, 1976 


l This Research is being supported by the Nationa 
Foundation Grant GJ-28401X, the Office of Naval 
Contract N000 1 4-67-A-01 9 1-002 3, and the Brown (Juiversit 
of Applied Mathematics; Principal Investigator Andries 


1 Science 
Resea rch, 
y Division 
van Dam. 






I sometimes feel, in reviewing the evidence on the design of 
computing systems, that the necessary conclusion is that 


de-kludging just is not 
a mechanism which can 
Nevertheless, in spite 
does sometimes occur. 


possible. It is difficult to conceive of 
satisfy the conditi,ns necessary for it. 
of such evidence against it, de-kludging 


--adapted from Karl S. Lashley, 1950 
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Introduction 


1 INTRODUCTION 


1. 1 OVERVIEW 


The Brown University Graphics System: 


"The stated objectives of the project’s activities are an 
investigation into the area of medium-cost, 
microproyrammable, intelligent graphics terminals and the 
"division of labor" trade-offs between a mainframe 
processor and the intelligent satellite. In addition to 
these goals, we are also interested in examining the 
impact which microprogramming has on the design of other 
aspects of a graphics terminal, for example, system 
configuration and the local operating system design." 

--George M. Stabler 
The BUGS Overview 


The META 4B / SIMALE / Vector General comprise the core of 
the graphics facility of the Brown University Graphics System 
(BUGS). The purpose of this document is to present the 
concepts and facilities of this core in such a way as to make 
it easy to learn and pleasing to use by people at all levels 
of design and implementation. 


In order to accomplish this goal, BUGS has herein been 
formalized and conceptualized beyond the level done in other 
documents pertaining to the system (a list of such documents 
is presented in references). It is hoped that by so doing, 
the various facilities can be made more understandable, more 
useful, and hence more enjoyable. If this should turn out not 
to be the case, however, any comments, suggestions, etc., 
would be greatly appreciated and carefully considered. 


1.2 SYSTEM COMPONENT CONCEPTS 


How are the hardware components from which BUGS is constructed 
interconnected and how do they interact? All components can be 
divided into one of two classes, known as units and stores. 
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1.2.1 UNITS 


Units are those components of the system capable of 
performing manipulation of and computation upon data. In 
this way, a unit is an active component, whose purpose is to 
allow a person to perform the operations necessary to solve 
his problem. All units can, in turn, be divided into two 
sub-classes, known as processo rs and inp ut /o utput units. 


li.2ili.l_ PROCESSORS 

Processors are units wnose behavior is capable of 
being controlled and changed at will, that is, they are 
programmable. Thus the word processor is used in the 
conventional sense to denote a "computer" or a "CPU". A 
processor consists of hardware which is capable of 
executing a set of primitive commands, known as host 
in struct ions. which can be used directly by programmers 
to implement their applications. 


Ji.2iJi.2_INPU I/O UTPUT_U NI1S 

An input/output (I/O) unit is a hardware device which is 
not programmable, hence having a fixed function (e.g., a 
card reader or a console terminal) . Although I/O units 
are capable of performing some manipulation of data, 
their principal function is to transmit and present data 
to other system components and to human users. 
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1.2.2 STORES 


A store is a passive component of the system whose sole 
capability is that of retaining or remembering data. It is 
the conventional memory space of a computer, although 
various types of stores with various operating speeds may 
' be present on the system. Examples of stores on BUGS are 
main core storage and secondary disk storage. 

Each of the above components will be described in greater 
detail below. Simply keep in mind the simple picture of 
stores containing programmer-defined data structures; these 
data structures are operated upon in a fixed manner by I/O 
units, and in a variable manner by the processors. 


1.3 COMPONENT DESCRIPTIONS 


The diagram on the following page pictures the various 
components of BUGS and their interconnections. Data is, in 
most cases, transferred among components in groups of sixteen 
bits, called halfwords. Furthermore, most stores are 
half word-oriented, also containing data in 16-bit groups, each 
halfword accessable via an address specified by a number from 
zero to n. (The exception is the SIMALE, as described later.) 
The following paragraphs describe the components in greater 
de tail. 


1.3.1 PROCESSORS 


There are three processors in BUGS: the META 4A, META 4D, 
and the Super-Integral Multi-purpose Arithmetic/Logic 
Expediter (SIMALE). Each processor has three stores for 
its own internal use, and may be connected to a variety of 
I/O units. 

As was previously mentioned, each processor is capable of 
executing a set of primitive host instructions. Programs 
composed of these intructions reside in a program memory 
known as control store. It is from control store that the 
processor fetches, decodes, and executes host 

instructions. 

Programmers using host instructions require work space in 
which to keep operands, temporary results, etc., and with 
wnich to communicate to other units. This work space comes 
as a set of halfwords known as a register file. Each 
processor has its own register file. 
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Finally, each processor is equipped with a relatively large 
store for retaining larger amounts of information 
such as tables, matrices, cr data lists. Altnougn smaller 
than main store, local store is at least an order of 
magnitude faster, and hence should be used for retaining 
often-used information. 


1. 3. 1. 1 META 4A 


The META 4A processor is composed of a Digitial 
Scientific Corp. META 4 computer. The META 4A is 
equipped with control store consisting of 4K 2 halfwords 
of read-onl^ memory; (ROM), making modification of host 
programs difficult. The register file consists of 32 
halfword registers, many of which serve special 
purposes. Local store has not yet been implemented and 
is unavailable to the programmer. 

The I/O units connected to the META 4A include a disk 
controller, a console terminal, a control panel, and a 
general-purpose binary switch. In addition, the META 4A 
is connected via a multiplexor channel to a S/360-67. 


Ii.ii.iiI_META_.4B 

The META 4B processor with its stores is identical in 
nature to the META 4A, although it is equipped with IK 
halfwords of local store. 

The only I/O unit connected to the META 4B is the Vector 
General (VG) high-speed CRT tube used for graphical 
display. 


iiii.lt 3_THE_SI MALE 


The SIM ALE is a high-speed 
composed of four independent sub 
intended to be used solely f 
necessary for graphical transfo 
into a completely general-pur 
equipped with 256 halfwords of 
control store which contains 
addition, each sub-processor h 
three 18-bit registers, and a 
18-bit locations. There are no 
the SIMALE. 


unit wnich is actually 
-processors. Originally 
or the matrix operations 
rotations, it has evolved 
pose processor. It is 
fully readable-writeable 
the host program. In 
as a register tile with 
local store with sixteen 
I/O units connected to 


2 "K" stands for "times 1,024". 
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I 

It should be clear from the diagram that data paths 
exist between the SIMALE and the META 4B, and between 
the META 4B and the META 4A. 


_1 i _3 i _l i _4_M A I^N_S TOEE 

Main store is the central data memory for the system. 
It is accessable from both the META 4A and META 4B 
processors, so that it can contain data structures, 
programs, etc. It can also be accessed directly by the 
disk controller so that data transfers can be made 
directly to and from main store without processor 
intervention. A halfword can be transferred to or from 
main store in 900 nanoseconds. 

We are currently equipped with 32K halfwords of main 
store. 


Jiiili5_DISK_ST0KE 

Disk store is implemented on large circular packs, each 
of which contains 512,000 halfwords. These packs are 
removable and replaceable, hence allowing virtually any 
amount of backup storage. However, data is accessed via 
the disk controller I/O unit, and the access time is 
extpemely slow, averaging approximately 250 
milliseconds. 


1_^4_S YST EM_STR UCTU RE 


It has been said that, given the components described above, a 
user/programmer could implement his applications using the 
host instructions provided by the processors in conjunction 
with stores and I/O units. This would be extremely crude, 
however, given the rather primitive nature of these 
instructions, the fixed ROMs in the META 4A and META 4B, and 
the lack of programming facilities in general. 

To alleviate this problem, the designers of BUGS have 
provided the user with various facilities to aid him in his 
work. These facilities are embodied in an overall system 
struct ur e: this structure encompasses various conceptual 

levels into which the facilities fall. Each level has the use 
of those facilities supported by the lower levels, and in 
turn offers various additional facilities to the levels above 
it. The system structure is pictured below and described in 
the following paragraphs. 
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1.4.1 USER 
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structure is the user himself, 
acilities supported by the levels 
the level at which he can design 
closer to the problem description 
on the bare hardware. He comes in 
g three levels: 


1.4.2 PROGRAMMING LANGUAGES 


The programming language is the user’s vehicle for 
expressing the computations he wishes to perform. Ideally 
this programming language would be full English, however 
current technology allows only simple artificial languages, 
ranging across a spectrum starting with such high-level 
languages as PL/1 and continuing down to a language which 
is directly executed by the hardware (i.e., the host 
language). On BUGS we will have a high-level language 
called ALGOL W, and currently have a low-level PL/360-like 
language called PL/BUGS, and assembly language, to be 
described later. 


1.4.3 MONITOR 


The monitor, also called the operating system, is a 
comprehensive package of programs provided to the user for 
performing standard and often-used functions. These 
functions include I/O unit control, management of storage 
space, program control, etc. 


iiiiii_EXTMi2llS_li2iITgR 


The extended monitor comprises an extension to the monitor 
which is specifically oriented toward the application with 
which the user is involved. Such extensions might include 
graphical support packages, scientific subroutines, or 
communications programs. The extended monitor provides 
those useful facilities which do not belong in the standard 
monitor because they are not generally used by all 
applications. 
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I A 4 t 5_Q-INTERPRETEB 


As we have said, the user expresses his algorithms in a 
programming language, as opposed to directly in host 

instructions. Clearly then, we must have a program, called 
a compiler, which takes the user's programs and translates 
them into a sequence of host instructions. This is a very 
difficult task, however, due to the primitiveness of the 
host; current compiling techniques dictate that such 
compilation would be extremely inefficient and 

time-consuming. We might then be forced to design 
programming languages that were lower-level, closer to the 
host -- in the worst case we could require the user to 
specify each host instruction individually, something 
which we stated would be unreasonable. 


In order to make high-level languages possiule, and in 
order to provide the user with a reasonably useful language 
in the absence of a high-level one, we have provided a 
q-interpreter (commonly called an emulator) to act as an 
interface between the host machine and the programming 
language. The q-interpreter, written in the host 
instructions and residing in control store, provides 
facilities which are much more useful than the host itself. 
Such facilities may include the interpretation of 
higher-level intructions or data structures, control of I/O 
units, control of communication with other processors, etc. 
In other words, the q-interpreter provides the well-known 
assembly language instruction set. 


Ideally 
for eac 
compile 
designe 
However 
out, e 
exploit 
had to 
and all 


, many different q-in 
h application, one for 
into, etc. Each of 
d so as to be well-sui 
, the existence of ROM 
xcept in the case of t 
ed, as described later) 
be designed which was 
programming languages. 


terpreters could exist, one 
each high-level languages to 
these q-interpreters could be 
tqd for its intended purpose. 

for control store rules this 
he SIMALE (where it is fully 
. Therefore, a q-interpreter 
useful for all applications 
obviously a hopeless task. 


is.4i6_EXTENI)ED_2- INTERPRETER 


In order to help alleviate the unadaptability of the ROMs, 
an extra level has been added between the q-interpreter and 
the programmming language. This level, implemented using 
the facilities provided by the q-interpreter, extends the 
q-interpreter by supporting additional facilities in a 
manner transparent to the programming language. Since the 
extended q-interpreter is programmable just like higher 
levels of the structure, features can be added with ease, 
debugged, experimented with, etc. However, the 
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programminy language uses them just like any other feature, 
and hence need not know that they are not really part of 
the g-interpreter. Eventually, when a feature is 
completely implemented, it can be moved down into the 
g-inter preter, causing an increase in speed with no 
reproyramming necessary. 

Due to their implementation, each level tails into one of 
three categories, depending upon its "solidity". The most 
solid is the hardware, changeable only via engineering 
modifications. Next, the q-interpreter, although changeable, 
is "firm", both because it may reside in ROM and because it is 
somewhat difficult to program. Finally, the remaining levels, 
the majority thereof, are "soft" -- easily programmable and 
adaptable. 


1.5 ONWARD 


The remainder of this document is devoted to describing the 
META 4B / SIMALE / Vector General units of BUGS. The next few 
chapters describe the facilities provided by the META 4B 
g-inte rpre te r. 
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2 DATA FACILITIES 


2. 1 INTRODUCTION 


The META 4B, with .its q-interpreter, becomes a 

genera 1-purpose processor. It provides many storage and data 
types to the programmer with which he can design and implement 
any type of data structures and data bases necessary for his 
application. In order to operate upon this data, a 
comprehensive set of instructions is provided, which can be 
used directly in assembly language or via a high-level 
language and its compiler. 


2.2 PROGRAMMER STORES 


There are four types of stores provided to the META 4B 
programmer: register file, local store, main store, and the VG 
register file. These stores are described briefly in the 
following paragraphs; more detailed information is given in 
the course of this document. 


2.2.1 REGISTER FILE 


The programmer, rather than using the processor's register 
file, is provided with a more extensive one of his own. 
This register file consists of 64 halfword registers, 
divided into tour groups of sixteen each. 

The first group, numbered 0 - 15, is called the 

neral-j:urjoose registers (GPR) . These registers can 
be used to contain numeric data for purposes of 
arithmetic or comparison, address data, program 
flags, etc. They are the major store for performing 
data operations, and can be referenced by all 
instructions. 

The second group, numbered 16 - 31, is the control 

registers. These registers are used by the 
g-inter pre ter to control the execution of a user's 
program. Access to these registers might be useful to 
tne programmer, and hence they are included in his 
register file. 

The third group, numbered 32 - 47, is the ET CE TERA 
instruction r egis ters. Refer to Chapter 16. for an 
explanation of this group. 
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X 


The final group, numbered 48 
external registers, used as a 
between the programmer and the SI 


- 63, is the SIMALE 
communication area 
MALE processor. 


2 . 2.2 LOCAL STORE 


The META 4B is equipped 
(soon to be expanded to 
often-used data, both for 
The contents of the first 
follows: 


with a 256-haltword local store 
IK). This local store contains 
the user and the q-interpreter. 
96 locations are pre-defined, as 


The first 
corres pond 

0 - 15. 


sixteen halfwords, numbered 0 - 15, 

one-for-one with general-purpose registers 


Locations 16 - 31 

data queue between 
is necessary in 
display on the VG. 


are used by the q-interpreter for a 
the SIMALE and the VG. This queue 
order to maintain a high rate of 


Locations 32 - 47 correspond one-for-one with the ET 

CETERA instruction registers 32 - 47. 


Locations 48 - 63 correspond one-for-one with the 
SIMALE external registers 48 - 63. 

Locations 64 - 95 contain the information necessary to 
maintain the swapping of SIMALE virtual control store 
pages to and from real control store. These 32 
halfwords are called the SIMALE virtual control store 
gage table. 

All local store locations from 96 on up can be used by the 
programmer for any purposes he desires. 


2.2.3 MAIN STORE 


The META 4B, along with the META 4A, has access to main 
store which is equipped with 32K halfwords. These 
halfwords comprise the major store for both the user's data 
structures and his programs. 

There is a major difference between the hardware operation 
of main store and the way the programmer uses it via the 
q-interpreter. Instead of addressing a set of halfwords, 
the programmer addresses sequential groups of eight bits, 
called b^tes. Each byte is assigned an address starting 
with zero and continuing up to 48K (currently). In effect. 
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then, the low-order bit of an address specifies one of two 
bytes within the halfword addressed by the remaining bits. 


In spite of 
requires that 
byte address, 
requirement is 


this added flexibility, the q-interpreter 
certain 16-bit data be located at an even 
i.e., not cross a halfword boundary. This 
called halfword al ignment. 


2 i 2 i .4_YECTOR_GENERAL_REGISl£;P_FILE 


The VG display unit is equipped with a register file 
containing 85 registers of varying sizes (none greater than 
16 bits). These register are used to control the display, 
handle user input devices, and provide information to the 
programmer. 


2.3 DATA TYPES 


We have described the data stores 
programmer; what sort of data can 
variety of data types exist, each 
olving certain types of problems, 
ivided into two classes; numeric and 


which are available to the 
he keep in these stores? A 
of which is useful for 
These data types are 
string. 


The operations which can be performed 
described beginning in Chapter4. 


on these data types are 


2.3.1 NUMERIC DATA 


2iJi.liJ_INTEGERS 
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000...000 = 0 

(base 

10) 







000...001 = 1 









1 11... Ill = -1 









111...100 = -4 
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The value of an n-bit signed integer ranges from 
_2**(n-1) up to +2**(n-1) -1. Thus a halfword integer 

can have the values -32,768 up to +32,767. 


It is also possible to work with unsigned integers, 
which are called logical. The value of a n-bit logical 
integer ranges from 0 up to + 2**n -1. The most 
important use of logical integers is for addressing data 
stores, which have locations numbered from 0 on up. All 
references to stores must eventually generate a logical 
integer to act as the final location address. 


2. 3. 1.2 FRACTIONS 


It is possible for the programmer to work with signed 
fractions on the META 4D. A fraction is represented as 
an n-bit two’s-complement binary number, the high-order 
bit indicating the sign. The binary point is assumed to 
lie between the sign bit and the next high-order bit. 
This allows fractions in the range -1.0 up to +.999... 
Examples of fractions are: 


0 

10 .. 

.000 

0 

11 .. 

.000 

0 

11 .. 

.111 

1 

10 .. 

.000 

1 

00 .. 

.000 


.5 (base 10) 
.75 

.999... 

-. 5 

- 1.0 


Fractions are 
because the 
coordinates. 


a necessary 
VG display 


data type on the META 4B 
scope uses fractional 


INDEX-BASE-DISPLACEMENT 


An index-base- 
present only 
generate an 
purposes duri 
Typically this 
a main store 
bytes for the 


displacement (XBD) is a data type which is 
within instructions. It is used to 
integer which can be used for various 
ng the execution of the instruction, 
integer is treated logically and used as 
address in order to obtain one or more 
instruction to operate upon. 


The integer is generated from the sum of three other 
integers specified by the index, base, and 
displacement. The base is a 4-bit field (called the B 
field in the instruction) which specities one of the 
sixteen general-purpose registers, the contents of which 
is treated as an integer. Added to this integer is the 
contents of the GPR specified by the 4-bit index (X) 
field. Finally, the displacement, a 12-bit logical 
integer present immediately within the instruction (in 
the D field) is added. If the base or index field 
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specifies GPRO, that field is ignored and GPRO is not 
added to the sum. 

If the XBD is to be used as an address, the above 
computation will produce the expected result regardless 
of whether the X, B, or D components are considered to 
be signed or logical integers; the final sum is a 
logical integer specifyirg a location in main store. 


2 A 3^.14_PR0C ED UR E_D1 SP LACE WE NT 

See Chapter 3.1.1 for an explanation. 


2.3.2 STRING DATA 


2. 3. 2. 1 BYTE 


A byte is the simplest form of string data. It consists 
of any single byte of information, which could be an 
8-bit number, a character, or a flag. A byte is also a 
character string of length one (see next paragraph). 


^i.3 i .2 i 2_CHAR ACTER_ST RING 

A character string is a seguence of bytes in main store, 
having a length from zero (the null string) to 65, 535. 
Character strings are used to represent arbitrary length 
logical data (e. g. , a PL/I bit string) or character 
strings in the usual sense (e.g., messages). 
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3 PROGRAM FACILITIES 


The q-inte rpreter provides a comprehensive set of facilities 
which can be used directly in assembly language or via a 
high-level language. Specifications for a high-level language 
such as ALGOL W will hide many of the q-interpreter features from 
the programmer and hopefully make it easier to program. However, 
it is the purpose of this document to present ail of the features 
for posterity; hence we will be oriented toward the assembly 
language programmer. 


It is assumed that the reader is familiar with the META 4A 
Principles of Operation and the facilities provided by Waterloo 
Assembler G (ASMG). The differences between S/360 ASMG and 
BUGSASM A, which are outlined in the META 4A Assembler Users' 
Guide, do not hold for the META 4B, however. Any differences 
will be presented in this document. The general format used 


herein is 
con junction 


to present each 
with BUGSASM B. 


META 4B feature and its use in 


The metalinguistic symbols used in 
syntax are described in Appendix 0. 


this document to specify 


3 i _1_PR0C EDUR E_DESCRI PTION 


3.1.1 INTRODUCTION 


grammer is accustomed to thinking of his 
euce of individual computations leading to 
is problem. Programming practice dictates 


The average pro 
program as a sequ 
the solution of h 
that these comput 
of associated c 
specific portion 
such a concept b 
P£ 2 £edures. Seg 
procedure call 
procedure, oth 
explicitly by 
g-interpreter) , 


The q-interpre 
procedure, called 
this procedure 
register file. The first, control register 1b, is called 
the Procedure Base Register (PBR). It simply contains the 
main store address of the beginning of the current 
procedure (remember, main store is addressed in bytes!). 
Since a procedure must begin on a halfword boundary, the 


ations 

sho 

uld 

be grou 

ped 

into logical 

sets 

omputa 

tion 
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each 

of 

which perfor 

ms a 
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e ov 

er al 
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META 4B supports 
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be split up 

into 

uenc in 

g o 

f 
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the 
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execut 
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retu rn. 
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executing a spec 
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the 

curr 

ent 

procedure. 

The executio 
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by th 
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registers in 
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PBR is always forced to be even (i.e., the low-order bit 
is ignored). In addition, whenever a new procedure is 
entered, GPR15 in the register file is set to contain a 
copy of the PBR. This is useful for implicit addressing of 
static data in the procedure, and should not be modified 
by the programmer. 


PBR 

| proc. address 0| 
o is 


The third register is the Procedure Displacement Register 
(PDR) , control register 17. It contains the byte 
displacement from the PBR to the next instruction to be 
executed. Whenever the q-interpreter is ready to execute 
an instruction, it fetches it from the locations specified 
by the sum of the PBR and PLR, and then adjusts the PDR so 
as to be ready for the next instruction. 


Procedures are limited to 4K 
instructions must be on 
low-order bit of the PDR is 


bytes in 
halfword 
ignored, a 


length. Furtherm 
boundaries, so 
s with the PBR. 


ore, 

the 


PDR 


lOCOOproc. disp.O| 

0 4 15 


Procedure displacements are a standard 
reside in areas other than the 
instructions which alter the normal 
path (branching instructions) contain 


data type, and 
PDR. For exam 
sequential execu 
such displacemen 


can 

pie, 

tion 

ts. 
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3.1.2 PROGRAMMING 


A single assembly may contain any number of procedures, 
each of which is coded as fellows; , 

[EXTERNAL] PROC <name> 


(procedure code) 


static data 

The PROC statement specifies the start of a new procedure 
with the name indicated by <name>. Each procedure must 
have an identifying name. If the scope of the procedure is 
to be external, that is, if the procedure name can be 
referenced by other assemblies (e.g., via V-constants), 
the specification EXTERNAL must be included. 

Following tne PROC statement is up to 4K bytes of code and 
data which performs the computations assigned to this 
procedure. Static data not used by other procedures should 
be placed at the end, including a LTORG statement to 
locate all literals. The PROC statement sets up a USING on 
GPR15 so that this data can be implicitly addressed. 

NOTE that it is not necessary to code a CSECT statement 
anywhere in the assembly. 


3.2 INSTRUCTION DESCRIPTION 


3 A 2 i 1_INTR0DUCTION 

Instructions on the MET 4B are similar to those 
System/360/370[ ]. Each instruction consists 
operation, which specifies some function to be 
upon one or two operands. 

The operation is specified in an instruction by a four-, 
eight-, or twelve-bit operation code. This code specifies 
not only the basic function to be performed, but also 
certain modifiers, such as the data type of the operands. 
Each different operation code is given a mnemonic for use 
in assembly language programming (e.g., "A" for add). 

Operations can be performed upon single operands (unar^ 
operations) , or upon two operands (binary operations) . 
"Reference codes" are appended to an operation mnemonic to 


on an IBM 
of an 
performed 
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specify the data type and location of the operands (e.g., 
M ARR" for adding the contents of two general-purpose 
registers). The next section describes the various types of 
operands and their reference codes. 

When programming in assembly language, instruction operands 
are specified in their logical order. The instruction 
descriptions in the document give the symbolic format for 
these operands. A general-purpose register is shown 
symbolically as an "R", while an XBD address is shown 
symbolically as "D{X,B)". A symbolic operand may have a 
"1" or a "2" suffix to denote which operand it is, or an 
" S" or "D" suffix to denote source and destination. Thus 
an instruction to add two registers is shown as: 

ARR R1,R2 


3.2.2 OPERANDS 


Various restrictions are placed upon data types if they are 
to be operated upon directly by an instruction. These 
restrictions are outlined here: 


3 i 2 i 2 i l_lNTEGERS 

In most cases, integers must be sixteen bits in length 
in order to be operated upon by instructions. In a few 
cases they must be 32 bits long, such as for the 
dividend in a divide operation. These integers may 
reside in the general-purpose registers {and if so are 
given the reference code "R"), within instructions as 
immediate data (code "I”), or within a halfword in main 
store (code "fl") . 


3.2. 2.2 FRACTIONS 

The restriction placed upon integers also hold for 
fractions. 


3. 2. 2.3 INDEX-"BA SE -DISPLACEDENTS 

XBD data can only reside within instructions, and are 
given the code 11 A". They consist of a four-bit X field, 
a four-bit B field, and a twelve-bit D field. 


- 17- 









Program Facilities 


PROCEDURE-DISPLACEMENTS 

Procedure displacements typically reside within the PDR 
control register or branching instructions, but they can 
also be stored in GPRs (code "R") or halfwords in main 
store (code "H"). Since they require only twelve bits, 
the high-order four bits of the register or halfword are 
ignored and assumed to be zero. 


3.2.2.5 BYTES 


Single byte data items can reside in the low-order eight 
bits of a GPR (code "R"), an instruction (code ”1")/ or 
in any byte in main store (code "B")« When in main 
store, bytes do not necessarily have to be on halfword 
bo undaries. 


3. 2. 2. 6 CHARACTER STRINGS 


Character strings can only reside in main 
given the code "C". They may begin on any 
and be of any length from 0 (the null 
65,535 bytes. 


store and are 
byte boundary 
string) up to 


3j_3_ PROC EDU R E_CH EC KS 


Certain errors can arise during the execution of a program, 
such as an attempt to divide by zero. The q-interpreter 
provides a means of informing the monitor and/or user of these 
errors, a means called proc ed ure checks. When an error is 
detected, execution of the instruction in question is aborted, 
and an implicit procedure call occurs. A detailed explanation 
is given in Chapter 12. 

With each instruction description in the following chapters 
is given a list of the possible procedure checks that can 
occur and why. 
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4 THE TRANSFER DATA INSTRUCTION 


The purpose o£ this chapter is to serve as an introduction to the 
instruction set of the META 4B by describing a fundamental 
instruction, XFER. NOTE that the format used to describe this 
instruction will be used throughout the remaining chapters. 

Each instruction description consists of four parts: 

1. The name of the instruction. 

2. The mnemonic used when coding the instruction, followed by the 
symbolic format of the operands. 

3. A picture of the instruction as it resides in main store, 
with its operand code (hexadecimal) and operand fields. 
Unused nits are indicated by a slash. 

4. An English-language description of the instruction. 


transFER data 


XFER D, DD (BD) ,S,DS(BS) ,DN (BN) 

| FF |/ D 1/ S | BD | DD DS| BS | | BN| DN ] 

<-1-1-1-L-L_I_ L -1_I 

0 a 12 16 20 32 36 40 52 63 


The XFER instruction allows the programmer to transfer one or 
more halfwords of data from locations in one store to locations 
in the same or any other store. Data is transferred from the 
source store specified by S, starting at the location specified 
by DS(BS), to the destination store specified by D, starting at 
the location DD (BD) . The number of halfwords transferred is 
specified by ‘DN(BN), \ 

Addresses and the length are computed by adding the contents of 
the base GPR (ED, BS, or BN) to the immediate twelve-bit 
displacement (DD, DS, or DN), forming a logical integer. If a 
base field contains zero, GPRO is not added; the displacement is 
used by itself. The reader may have noticed that the addresses 
and length are XBD data types without the index. 

The stores which can be specifed in the three-bit. D or S fields 
and their idiosyncracies are as follows: 

code 0: Register file (R). Addresses are treated modulo 64, so 
that transferring wraps from register 63 to 0. 
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code 1: Local Store (LS). Addresses are treated modulo n, n 
being the current size of local store. Thus transferring 
wraps from location n-1 to 0. 

code 2: Pain Store (MS). The address must specify a halfword 
boundary. If it does not, an alignment procedure check 
occurs. 

code 3: Vector General Register file (VGR). Addresses are treated 
modulo 128, so that transferring wraps from register 127 to 
0. See chapter 15.2. for an explanation of the Vector 

General registers. 

codes 4-7: unused. It specified as a source, zeroes are obtained; 
if as a destination, the data falls off the face of the 
earth. 

If the number of halfwords to be transferred is zero, you 

wouldn't believe what happens. 


In order to simplify the specification of store types, 
registers, etc., a macro is provided which generates equates for 
them. This macro is called "M4BEQUS" and should be included at 
the end of all META 4B assemblies. A listing of the generated 
code can be found in Appendix 1. 

Examples: 

XFER R,R5,MS,PLACE,3 

Three halfwords are transferred from main store, starting at 
PLACE, into GPR5-7. 

XFER LS,256,LS,128,128 

128 halfwords are transferred from local store locations 
128-255 to locations 256-383. 


XFER LS,0 (R2) , VGR , V GDIA Li , 0 (R3) 

The number of Vector General dial registers specified by the 
contents of GPR3 is transferred into local store starting at 
the location specified by the contents of GPR2. 

XFER R, R 8 , R , DBR , 1 

The D3R is placed into GPR8. 


NOTE that XFER is not. intended for transferring single 
among the general-purpose registers and main store, 
other, more powerful, instructions for this purpose, 
described in later chapters. 


data items 
There are 
which are 
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5 BRANCHING INSTRUCTIONS 


5.1 INTRODUCTION 


A class of operations known as branching operations are 
provided to allow the program mer to make decisions and alter 
the flow of control through his procedures. Branching 
decisions are controlled by the Condition Blag Register. 


5.2 CONDITION FLAG REGISTER 


The CFR, control register 18, provides the means for making 
decisions in a procedure. It contains eight condition bits 
which are set by certain instructions in order to inform the 
programmer of the results of the instruction. For example, 
compare operations set the CFR to reflect whether the first 
operand was less than, equal to, or greater than the second 
operand. 

CFR 

\ flags IsToOOOOOOo] 

L_I_I_J 

0 7 8 1 5 


Whenever the CFR is modified by an instruction, all bits are 
initially set to zero. Next, one of the flags (bits 0-6) is 
set to reflect the results of the operation. (In the case of 
compares, bit 0 is set on if the operands are equal, bit 1 if 
the first operand is greater, or bit 2 if it is less than the 
second operand.) Finally, the summary flag, bit 7, is set to 
reflect the most important condition. (For compares, it is 
set off if the operands are unequal, or on if they are equal.) 

The purpose of some branching instructions is to test the CFR 
and either branch cr not, depending upon the test. 
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5.3 UNCONDITIONAL BRANCHING INSTRUCTIONS 


No operation 
NOP 0 

I OD |00 OOOOOol 

L_J_J 

0 8 IS 


NOP performs no operation whatsoever. Execution continues 
with the next sequential intruction. 


Branch 

B label 

r -r-1 

| 4 |proc. disp.O| 

i_ j-j 

0 4 IS 


A branch 
setting of 


is taken 
the CFR. 


to the specified label regardless of the 
Such a branch is called unconditional. 


Branch via Register 


BR R 

i- t -n 

| C FC | R | 

L -4_J 

0 12 15 

Branch via Halfword [Note the mnemonic] 
BH D(X,B) 

r- t-t --j-1 

I 9FC | X | B J D | 

»-1-1-—i_i 

0 1216 20 31 
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An unconditional branch is taken. For BR 
displacement is obtained from the GPR specifed 
For BH, it is obtained from the halfword a 
address specified. In both cases, the high 
of the operand are ignored. 

An alignment procedure check occurs during 
store address is odd. 


the procedure 
by the operand. 

the main store 
order four bits 


BH if the main 




Conditional Branching Instructions 


5.4 CONDITIONAL BR ANCHING. INSTfiUCTIONg 

Branch True 
BT label 

r- t-1 

I 3 |proc. disp.0 J 

L -X-J 

0 4 15 


Branch False 
BF label 

I-T-1 

| 2 Iproc. disp.Ol 

L-L-J 

0 4 15 


If the summary 
off and the 
specifed label 


flag is on 
opera tion 
Other wise 


and 

the 

operation i 

is 

EF , 

a nd 

branch 

no 

branc 

h is 

taken. 


BT, or if it is 
is taken to the 


Branch on Condition Flag register 
BCF mask,label 


I 5D | mask |0000proc. disp.Ol 

i-J-X-J 


o 


8 


1 6 


3 1 


The eight-bit masK is used to select bits in the CFR. If any. 
selected bits are on, a branch is taken to the label. 
Otherwise, no branch is taken. Each bit in the mask 
corresponds to a bit in the CFR. Wherever a one bit appears 
in the mask, the corresponding CFR bit is selected for 
testing. 

It is not usually necessary for the programmer to specify a 
mask on a BCF instruction. Instead, "extended mnemonics" 
are provided which allow the user to ignore the mask. Examples 
are BE (Branch Equal) and BNG (Branch Not Greater). Extended 
mnemonics ate described with the relevant instructions, and 
are also listed in Appendix 2a. 
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5.5 CASE 


CASE R,D(X,B) 

I faD |B . X i B T D ] 

0 8 121620 31 


V 


The main store address specifies a table of halfwords 
containing procedure displacements. The n'th halfword is 
selected, and a branch is taken to the procedure displacement 
within tnis halfword. As usual, the high-order four bits are 
ignored. The value of n is the logical integer in the GPR 
specified by R, and ranges frcm 0 on up. 

An alignment procedure check occurs if the table address is 
odd. 

In order to simplify the generation of CASE tables, the DCPD 
(Define Constant Procedure Displacements) statement is 
provided. It is coded as follows: 

[label] DCPD Ia.bel1,label2, ..., labeln 

A table of n procedure displacements is generated. 
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6 DATA MOVING INSTRUCTIONS 


6. 1 UNARY INSTRUCTIONS 


Set to Zero Register 
SZR R 


i- 

| CFO 

L_ 

0 


1-1 

I R i 

12 IS 


Set to Zero Halfword 
SZH D (X , 13) 

r-T-T-T-T 

| 9 FO | X | B | D | 

I_ J- _L-1_J 

0 121620 31 


These two instructions cause their operand to be 
For SZR, the specified GPR is set to zero, while 
halfword at the main store address is zeroed. 

An alignment procedure check occurs during SZH if 
is odd. 


Set 

to One 

Register 

SOR 


R 

r— 

1 

|_ 

CF1 

V R ] 

_L_J 

0 


12 15 


Set to One Halfword 
SOH D (X, B) 

| 9 Fl | X | B | D | 

1_I_L-1_J 

0 121620 31 


set to zero, 
for SZH, the 

the address 











Unary Data Moving Instructions 

These two instructions cause their operand to be set to the 
integer 1. For SOR, the specifed GPR is set to 1, while for 
SOH, the main store halfword is set to 1. 

An alignment procedure check occurs during SOH if the address 
is odd. 


/ 
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6.2 REPLACE 


Replace Register with Register 
RRR R1,R2 

4 I I I 

| 06 | R1 | R2 | 

0 a 1215 


Replace Register with Immediate 


RRI 

R1 , 1H 2 



| 56 

| HI i////| IH2 


1 

1 

_J 

0 

a 12 16 


3 1 

Replace 

RRH 

Register with Halfword 

R1 , D2(X2,B2) 


I 66 

i_ 

1-1-1-T- 

I R1 | X2 | B2 | 

i v 1 l 

C 2 

-1 

l 

_I 

0 

8 12 16 2 0 


3 1 

Replace 
RR A 

Register with Address 
R 1 , D2 (X 2 , B2) 



I--1 

o 1 1 
1 

j 1 

i SI 

1 1 

I 1 

■ t i — t *r 

| HI | X2 1 B2 | 

8 12 16 20 

D2 

1 

3 1 

Replace 

RRB 

Register with Byte 
R1 r D2 (X2,B2 ) 



86 

* T T- T T 

1 Hi | X2 | B2 | 

I- 

D2 

-1 

1 

_J 


0 8 121620 31 


Dfcfr r - 

H F 

H * 

e B 

c r 

A 


rc* 

RI 

HU 

HA 


HK 

1 1 

Hr 

( 

Hh 1 


r; 



Replace halfword with Register 

RiiR Dl (X 1, B 1) , R 2 

r- 1 -t-t- 1 -1 

| 96 | R2 | XI | B1 | Dl | 

0 8 121620 31 
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Replace 


Replace 

RBR 

Byte with Register 

D1 (XI,B1) ,R2 


r 

| A 6 

" TTTT 

| R2 | XI | B1 1 D1 

1 

1 

_ | 

0 

8 12 16 2 0 

3 1 

Replace 

RHI 

Halfword with Immediate 

Dl (XI ,B1) , IH2 



B6 T////T X1 T B1 T D1 T 1H2 ] 

0 8121620 32 47 


Replace Halfword with Address 
RHA D1 {XI ,B1) , D2 {X2, B2) 


| C6 

i . 

| X2 T XI T B1 T 

D 1 

T B2 T D2 

0 

a 12 16 20 


3236 4 7 

Replace 

RHH 

Halfword with Halfword 

Dl (XI ,B1) , D2 (X2,B2) 


r 

J D6 

1 1 1 1 

1 X2 | XI | B1 | 

- X _ X X _1. 

D 1 

)' B2 | D2 ] 

0 

8 12 16 20 


32 36 47 

Replace 

RBI 

Byte with Immediate 

Dl (X 1 ,B1) , IB2 



] E6 

i_ 

i////i xi i b i i 

D 1 

I////////! IB2 ] 

0 

8 12 16 20 


32 4 0 4 7 


Replace Cnaracter striny with Character string 
RCC Dl (X1,B1) ,D2 (X2,B2) ,DL(BL) 

i- t-t-1-t-t-1-1-1-1 

| F6 |X 2 J X1 |B1 | D1 |B2 | D2 | BL | DL | 

L-J-J_I-J_J_J_1_L_J 

0 8 12 16 20 32 36 48 52 6 3 
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Rep lace 


These instructions 
the second operand. 


cause 


v> 




RRR causes the GPR specified 
the GPR specified by R2. R] 
to contain te immediate 1 


e. 


*.*» RRH causes the GPR specified 

the specified main store address. 


first 

operand t 

o be 

repla 

ced 

by 

by R1 

to contain 

the 

conte 

nts 

of 

cause 

s the GPR 

specified 

by 

R 1 

If word 

. Immedia 

te 

data 

ma y 

be 

ex pre 

ssion. 





by R1 

to contain 

the 

half w 

ord 

at 








RRA causes the K1 GPR to contain the value of the specified 
XBD address. The address itself is the second operand -- no 
main store data is used. 



RRB 

ca us 

es 

t he 

low - 

cede 

r 

eight 

V* 

tne 

byte 

d 

t the 

mai n 

sto 

re 

add r< 


of 

the G 

PR 

are 

zeroe 

d. 




R HR 

caus 

es 

the 

half 

word 

a 

t the 

V 

the 

GPR 

sp 

ec’ifi 

ed by 

R 2. 




RBR 

ca us 

es 

the 

by te 

at 

th 

e mai! 

low 

- orde 

r 

eight 

bi ts 

of 

th 

e GPR 




RHI causes the specifed main store halfword to contain the 
immediate halfword. 


.ip- 




V '' 1 


RHA causes the specifed main store halfword (first operand) to 
contain the second operand XBD address. This address is not 
used to reference main store, but is itself the second 
operand. 

RHH causes the first operand main store halfword to contain 
the second operand main store halfword. 


RBI causes the byte at the main 
immediate byte. 


store address to contain the 


RCG causes a copy of the second operand character string to be 
placed into the first operand string. This copy is made by 
logically lifting the string cut of main store and setting it 
down in the first operand, so that no propagation occurs. The 
length of the two strings is specifed by DL(BL) , and is 
computed as follows: the contents of the GPR specified by BL 
(unless it is zero) is added to the twelve-bit displacement 
DL. 


An alignment procedure check can occur on any instruction 
requiring a halfword in main store if its address is odd. 


-30- 





Swap 


6._ 3_SW AP 

SWap* Register with Register 


SWRR 81,R2 

r-T-1- t 

| 07 | HI | R2 | 

i_ j _i_i 

0 8 1215 


R.H * HO. 
OB •> BO 


SWap Register with Halfword 
SWRH 81,D2(X2,B2) 

I 67 T R1 j X2 T B2 T D2 ] 

O 8 121620 31 


SWap Register with Byte 
SWRB 81,D2 (X2,B2) 

r - t - t - 1 -1-1 

| 87 | R1 | X2 | B2 | D2 | 

i_i_i_i_i_i 

0 8 121620 31 


SWap Halfword with Register 
SW HR D1 (X 1,B1) , R2 

r- t-t-t -r- t 

] 97 | 82 | XI | B1 | D1 | 

i_i_ j_j_j_j 

0 a 121620 31 


SWap Byte with Register 
SWBR D1(XI,B1),R2 

r-,- 1 - 1 -^- n 

I A7 | 82 | XI | B1 | D1 | 

0 8 121620 31 


SWap Halfword with Halfword 
SW HH D1 (XI,B1) ,D2(X2,B2) 

[ D7 | X2 T X1 T B1 T D1 

L_1_I_J_J_ 

0 8 12 1620 


T-1-T 

| B2 | D2 | 

j_ j_J 

32 36 * 7 
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SWap Character string with Character string 
SWCC D 1 (X 1 ,B 1) ,D2 (X2 ,B2) ,DL (BL) 

(mac ro) 


Swap 


Trie swap operation is used to interchange the contents of the 
two instruction operands. 


SWRR causes 
swapped. 

the 

contents 

of 

the 

two 

specifed 

GPRs 

to be 

SWRH causes 

t he 

content s 

of 

the 

GPR 

and the 

main 

store 


halfword to be swapped. 

SWRB causes the low-order eight bits of the GPK to be swapped 
with the byte in main store. The high-order eight bits of the 
GPR are set to zero. 

SWUR performs the same function as SWRH. 

SWBR performs the same function as SWRB. 

SWHH causes the contents of the two main store halfwords to be 
swapped. 

SWCC causes the two character strings to be interchanged. The 
length of the strings is specified by DL(BL) . As with all 
character string operations, no propagation occurs. SWCC is 
not implemented in the g-interpreter, but rather by a macro 
which generates three XCC instructions. 

An alignment procedure check will occur on instructions which 
specify a main store halfword not on an even boundary. 
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Arithmetic Shift Instructions 


7 SHIFT INSTRUCTIONS 


7.1 INTRODUCTION 


The shift instructions allow the programmer to shift the 
contents of a 16- or 32-bit value in the GPRs. The first 
operand is always a GPR number specifying the GPR(s) whose 
contents are to be snifted. The second operand specifies the 
shift count (number of nit positions to be shifted) , which 
can be located immediately within the instruction or in a GPR. 
Immediate counts are four bits long, allowing a value from 
zero to fifteen. If the count is in a GPR, the low-order five 
bits are used, allowing a value from zero to 31. 


7.2 ARITHMETIC SHIFT INSTRUCTIONS 


Left SHift, Immediate 
LSHI R 1,IX 2 


J 14 

—r t *i 

| R1 11X2 \ 

0 

8 12 15 

Left SHift, Register 

LSHR 

R 1, R 2 

r ic 

j R1 | R2 1 

_J_ L _J 

0 

a 12 15 


Right SHift, Immediate 
RSHI R1,1X2 

I-1-T-1 

| 15 | R 1 |IX2 | 

i_i_i_ j 

0 S 12 IS 
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Arithmetic Snift Instructions 


Right SHift, Register 
RS HR R1,R2 


r 



1 ID 

1 

R1 

| R2 

i. 

-L 

-L 

0 


8 

1 2 

The c 

onte 

nts 

of 

direct 

ion 

of 

shif 

ca use 

vaca 

ted 

bit 

shifts 

ca 

use 

the 

(origi 

na 1 

bit 

0) 


field 1X2 
R2. 


or 


the 


the GPR specified by R1 is shifted. The 
t is specified by the op code: left shifts 
positions to be filled with zeroes; right 
m to be filled with the original sign bit 
. The shift count is either the immediate 
low-order five bits of the GPR specified by 


NOTE that these shifts can be used to multiply or divide the 
GPR by a power of two. 

If, during left shifts, a bit unlike the original sign bit is 
shifted into bit 0, overflow is considered to have occurred, 
because a significant bit has been shifted out of the 
register. Such a condition is reflected in the CFR: flag bit 
1 is set off if it does not occur or on if it does (the 
summary flag is always off). lhe extended mnemonic BO (Branch 
on Overflow) can be used to test this condition. NOTE that it 
is impossinle to branch on nc overflow; overflow is the one 
exception to the CFR-setting rules described in Chapter 5.2. 


Left SHift Double, Immediate 
LSHDI R1,1X2 

\ 16 T R1 TlX2 1 

L-1_I_I 

o a i2is 


Left SHift Double, Register 
LSHDR R1,R2 

r- t-«-1 

| IE ( R1 | R 2 | 

L_J_I_J 

0 8 1215 
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Arithmetic Shift Instructions 


Right Sriift Double, Immediate 
RSI1DI R 1,1X2 


i 17 

L 

T T 1 

1 Rl J1X2 | 

0 

8 1 2 1 S 

Right 

RSHDR 

SHift Double, Register 
Rl, R2 

r 

1 IF 

L 

r m t i 

| Rl 1 R2 | 

0 

8 12 15 


These instructions operate exactly 
above, except tnat a 32-bit operand 
The low-order sixteen bits of the 
specified by Rl, while the high-order 
previous (I said HESXious) GPR (i.e.. 


as the 
(GPR pa 
operand 
sixteen 
Rl-1). 


A register specification procedure check 
since no previous GPR exists (GPR-1?) 


CCCUL 
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four explained 
r) is shifted. 

are in the GPR 
bits are in the 


if Rl is zero. 









Logical Shift instructions 


7.3 LOGICAL SHIFT INSTRUCTIONS 


Left SHift Logical, Immediate 
LSHLI R 1,1X2 


1 10 
L 

0 

T R 1 T 1X2 i 

X J. J 

8 12 15 


Left SHift Logical, 
LSHLR R 1, R 2 

r — r t i 

| 18 | R1 | R2 | 

L _L _L J 

Register 

0 

8 12 15 


Right 

RSHLI 

SHift Logical, 
R1,1X2 

Immediate 

1 1 1 
L 

0 

I R 1 |lX2 ] 

X X J 

8 12 15 


Right 

RSHLR 

SHift Logical, 
R1 , R2 

Regis te r 

r ,9 

r ' t i 

| R1 | R2 | 


0 

8 12 15 



The contents of the GPR specified by R1 is shifted. The 
direction of shift is specified by the operation code: both 
directions cause vacated bit positions to be tilled with 
zeroes. The shift count is either the immediate field 1X2 or 
the low-order five bits of the GPR specified by R-2. 

The CFR is unchanged. 
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Logical Shift Instructions 


Left SHift Logical Double, Immediate 
LSHLDI R1,1X2 

I 12 | R1 IlX2 ] 

0 8 1 2 1 5 


Left SHift Logical Double, Register 
LSHLDR R1,R2 

i-1-r-1 

| 1A J HI | R2 | 

L-L-L-J 

0 8 1215 


Right SHift Logical Double, Immediate 
RSHLDI R 1,1X2 

r -1-1 -t 

I 13 I R1 |IX2 | 

0 8 1215 


Right SHift Logical Double, Register 
RSHLDR R 1, R 2 

j IB | R1 | R2 | 

<_j _x_J 

0 8 1215 


These instructions operate exactly as the four explained 
above, except that a 32-bit operand {GPR pair) is shitted. 
The low-order sixteen bits of the operand are in the GPR 
specified by Rl, while the high-order sixteen bits are in the 
previous GPR (i.e., Rl-1). 

A register specification procedure check occurs if Rl is zero, 
since no previous GPR exists. 
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Arithmetic Instructions 


Test 


8 ARITHMETIC INSTRUCTIONS 


8 i J_TEST_SIGN 


Test Sign Register 
TSR R 


t - 

| CF8 

i_ 

o 


I R I 

j_j 

12 IS 


Test Sign Audress 
TSA D(X,B) 


r - t-t-1-1 

| 7F8 | X J B | D | 


0 


12 16 20 

J 

3 l 

Test 

Sign 

Halfword 


TSH 


D(X,B) 


1-- 

1 

9F8 

■" T" T T 

1 X | B 1 

1 o 1 
I i 
i 

1 

i i 

LJ 


O 121620 31 


The operand is treated as a 
tested. The CFR is set as 
operand is zero; bit 1 if it 
negative. The summary flag 
zero, or 1 otherwise. 


signed integer and its sign is 
follows: bit 0 is set if the 

is positive; or bit 2 if it is 
is set to 0 if the operand is 


The operand for TSR is the specified GPR. For TSA it is the 
XBD address itself. And for TSH it is the halfword at the 
specified main store address. 


Extended mnemonics are provided for use with the BCF 
instruction. They are: BZ (Branch Zero) , BN2 (Branch Not 

Zero), BP (Branch Positive), BNP (Branch Not Positive), BN 
(Branch Negative), and BNN (Branch Not Negative) . 


An alignment procedure check occurs during TSH if the halfword 
address is odd. 
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Unary Increment 


8i.2_UNARy_INCREMENT 
Increment Register 


IR 

R 



] 0 F2 

T 1 

1 R 1 

X J 



0 

12 15 



Incremen t 

Ha If word 



IH 

D(X,B) 



1 9F2 

T X 1”B I 

D 

1 

1 

L 




0 

12 16 20 


3 1 

Incr ement 

Increment Register 



IIR 

R 



r 

| 0F3 

i . 

T 1 

1 8 | 

X— —J 



0 

12 IS 



Increment 

Increment Halfword 



IIH 

D(X,B) 



9F3 

T T r- 

1 X | B | 

_|_|__|_ 

D 

] 

_j 

0 

12 16 20 


3 1 


The operand is incremented by one (IR, IH) or two (HR, IIH), 
depending upon the operation code. 

The operand for IR or IIR is the specified GPR, while for IH 
or IIH it is the halfword at the main store address. An 
alignment procedure check occurs if this address is odd. 
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Unary Decrement and Test 


8.3 UNARY DECREMENT AND TEST 


Decrement, Test Sign Kegiste 
DTSR R 

f 0 F4 | R 1 

0 12 15 

Decrement, Test Sign Halfword 
DTSH D (X , B) 

[ 9F4 T X | B \ D ] 

0 121620 31 


Decrement Decrement, Test Sign Register 
DDTSR R 

\ CF5 T K I 

L_I_I 

0 12 15 

Decrement Decrement, Test Sign Halfword 
DDTSH D (X , B) 

I 9F5 | X | B | D | 

0 121620 31 


The operand is decremented by one (DTSR, DTSH) or two (DDTSR, 
DDTSH), depending upon the operation code. Following this, 
the sign of the resulting number is tested, and the CFR is set. 
as for the Test Sign instructions described above. 

The operand for DTSR or DDTSR is the specified GPR, while for 
DTSH and DDTSH it is the halfword at the main store address. 
An alignment procedure check occurs if this address is odd. 


-40- 









Absolute Value and Negate 


8.4 ABSOLUTE VALUE AND NEGATE 


Absolute value Register 
A BSR R 

0 F6 | R "l 

0 1 2 1 5 


Ab solute 
ABSH 


1 9Fb 

l_ 

o 


value Halfword 
D (X,B) 

I X | B | D ] 

_i_i_ j_j 

12 16 20 3 1 


The operand is treated as a signed number and replaced by its 
absolute value. The absolute value of the maximum negative 
number is again the maximum negative number. 

The operand for ABSR is the specified GPR, while for ABSH if 
is the halfword at the main store address. An alignment 
procedure check occurs if the address is odd. 

Negate Register 
NEGR R 

| 0 F7 | R | 

L-J_J 

0 1 2 1 S 


Negate Halfword 
NEGH D (X , B) 


J 9F7 | X | B | D 

I_i_ JL _I_J 

0 12 1 6 20 3 1 


The operand is treated as a signed number and replaced by its 
negative. The negative of zerc is again zero. The negative of 
the maximum negative number is again the maximum negative 
number* 

The operand for NEGR is the specified GPR, wnile for NEGH it 
is the halfword at the main store address. An alignment 
procedure check occurs if the address is odd. 
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Add 


8.5 ADD 


Add Register plus Register 
ARR R1,R2 

| 0 1 | R 1 i R2 ] 

L-1-J-J 

0 8 1215 


Add Register plus Immediate 

ARI R1D # R1S,IH2 -or- Rl,IH2 


I 51 Trid Iris 7 ih2 ] 


t _ 

o 



1 6 


_I 

3 1 


Hr Hr 
HI Hi 
Hu Hh 
«A Ha 


Add Register plus Halfword 
ARH R1 ,02 (X2, B2) 

| 61 | R1 1 X2 | B2 I D2 | 

I_I_L_I_I_J 

0 8 121620 31 


Add Register plus Address 
ARA R1,D2(X2,B2) 

I 71 1 R1 | X2 | B2 T D 2 

0 8 121620 31 


Add Halfword plus Register 


AHR D1(XI,B1),R2 

r-T-T- 1 -T-T 

I 91 | R2 | XI | B1 | Cl | 

L-J-L-L- L _ J 

0 O 121620 31 

Add Half word plus Immediate 
AHI D 1 (XI,Bl) , 1H2 

i- 1 -1-t-t -r- 1 

I Bl I////| XI | Bl | D1 | IH2 | 

i. -1_ L _J_J_J_J 

0 8 121620 32 47 
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Add 


Add Halfword plus Address 
AHA D1 (XI ,B1) , D2 (X 2, B2) 

I-1-T-T-1-T-T-T 

| Cl j X2 | XI | B1 J D 1 | B2 | D2 | 

I-1-1-1_I_I_L_I 

0 B 121620 3236 47 


Add Halfword plus Halfword 
AHH D1 (XI, 61) ,D2(X2,B2) 

| D 1 T X 2 T X 1 T B1 T D1 ~i B2 T D2 | 

L_L_J_J_J_L_X_J 

0 a 121620 32 36 47 


The two operands are added together, and the first operand is 
replaced by the sum. Carry out of the sign bit is recorded in 
bit 0 of the CPU, while overflow (the 'exclusive or' of the 
carries out of the sign bit and bit 1) is recorded in bit 1 of 
the CFR. The summary flag is always zero. 

In addition to the BO extended mnemonic already described, 
there exists BC (Branch Carry). Remember, it is impossible to 
branch on no carry or no overflow. The operands for ARR are 
the two specified GPRs. 

For AR1, the first operand is really two operands. Execution 
proceeds as follows: The GPR specified by R1S is fetched, 
added , to the immediate halfword, and the sum is placed into 
the GPR specified by RID. Hence it is possible to add a 
constant to one GPR and put the sum in another. If only one 
GPR is specified, it is considered to be both RID and R1S. 

For ARH, the operands are a GPR and a main store • half word. 

For ARA, the operands are a GPR and the XBD addres s itself. 


For AHR, the operands are a main store halfword and a GPR. 

For AHI, the operands are a main store halfword and an 
immediate halfword. 

For AHA, the operands are a main store halfword and the XBD 
address itself. 


For AHH, 
alignmen t 
specif ying 


the operands are two main 
procedure check will occur 
a main store halfword not on a 


store halfwords. An 
on any instruction 
n even boundary. 
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Subtract 


8.6 SUBTRACT 


Subtract Instructions 


The second operand 
difference is placed 
is set as for the add 


is subtracted from the first, 
in the first operand location, 
instruct ions. 


and the 
The CFR 


The instruction 
instructions, exce 
than X* *1 •. Mne 
letter, which is " 


formats are ident 
pt that the opera 
monies are ident 
S" cather than "A" 


ical 

tion 

ical 


to those for the add 
code is X'*2 I rather 
except for the first 


An alignment procedure check will 
specifying a main store halfword not 


occur on any instruction 
on an even boundary. 
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Multiply Instructions 


8.7 MULTIPLY 


Multiply Register times Register 
MRR R1,R2 

i- t -r- t 

| 0 3 | R1 | R2 | 

O 8 1215 


Multiply Register times Immediate 
MRI 81 D, R1S, IH 2 -or- R1,IH2 

\ 53 Trid Iris T ih2 

O 81216 31 


Multiply Register times Halfword 


MRH R1,D2(X2,B2) 

[ 63 T P. 1 T X2 | B2 | D2 

0 8 121620 31 


Multiply Register times Address 
MR A R 1, D2 (X2, B2) 

I 73 | R1 | X2 | B2 T~ D2 

O 8 121620 31 


The first operand, which is always a GPP, is multiplied by the 
second operand to produce a 32-bit product. The low-order 
sixteen bits of this product are placed into the first operand 
GPR, and tne high-crder sixteen bits are placed into the 
previous GPR (i.e., Rl-1). A register specification procedure 
check occurs it the first operand is GPRO. 

For MRR, the second operand is the GPR specified by R2. 

MRI is special in that it allows the first operand GPR to be 
two operands. Execution procedes as follows: the contents of 
the GPR specified by R15> is multiplied by the immediate 
halfword. The low-order sixteen bits of the product are placed 
in the RID GPR, and the high-order sixteen bits in the 
previous one. If only one GPR is specified, it is assumed to 
be both R1S and RID. 

For MRH, the second operand is the specified main store 
halfword. An alignment procedure check occurs it its address 
is odd. 
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Multiply Instructions 


For MFA, the second operand is the XBD address itselt. 

It multiply instructions are used with fractions, the product 
must be shifted one bit tc the left to give the correct 
answer. 


> 





Divide Instructions 


8.8 DIVIDE 


Divide Register by Register 
DRR R1,R2 

r-1- t- i 

| 04 | R1 | R2 1 

(_i_j_j 

o a l 2 l s> 


Divide 

Register by 

Immediate 


DRI 

R1D,RIS, 

IH 2 -or- R 1 , IH2 


r 




| 54 

i 

| R 1 D | RlS 

i i 

I IH 2 

1 

_| 

0 

a 12 

1 6 

3 1 

Divide 

Register by 

Halfword 


DR H 

R 1, D2 (X2, 

B2) 


r 

' T - t " .. 

r " "" 

l 

| 64 

i 

| Rl | X2 

-l - I. 

I B2 | D 2 

1 

_J 

0 

a 12 

16 2 0 

3 1 

Divide 

Register by 

Address 


DRA 

R 1 , D2(X2 , 

B2) 


1 74 

r . v.. 

| Rl | X2 

I B2 | D2 

x _jl 

-1 

1 


0 8 12 16 2 0 31 


The first operand is the 32-bit dividend, the Low-order 
sixteen cits of which are in the GPR specified by Rl, while the 
high-crder sixteen bits are in the previous GPR. The second 
operand is the divisor, which is divided into the dividend, 
producing a quotient, which is placed in ttie Rl GPR, and a 
remainder, which is placed in the previous GPR. A register 
specification procedure check occurs if Rl specifies GPRO. 

For DRR, the divisor is in the GPR specified by R2. 

The execution of DRI is somewhat different than that of the 
other divide instructions. It procedes as follows^ the 
dividend is taken from the GPR specified by RlS and the 
previous one. This dividend is divided by the immediate 
halfword, and the quotient is placed in the GPR specified by 
RID. The remainder is placed in the previous GPR (i.e., 
R1D-1). If only one GPR is specified, it is assumed to be 
both RID and R1S. 
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Square Root 

For DRH, the divisor is the main store halfword. An alignment 
procedure check will occur if its address is odd. 

For DBA, the divisor is the XBE address itself. 

Fractional divides cannot be performed with these 
instructions. 

A division by zero procedure check occurs if the divisor is 
zero. The CFR is set to indicate overflow: bit 1 is set to 

zero if there was no overflow, or to one if there was; the 
summary flag is always zero. Overflow occurs it the quotient 
is too big to fit in one GPR. 


8.9 EXTEND SIGN 




Extend Sign of Register 
EXSR R 


r 

| 0F9 

I 1 

1- 1 

1 1 

1 a 1 

1 1 

1 1 

L. — -I 




0 

1 2 15 




The contents of the specified 
integer and extended to 32 bits by 
previous GPR. 

GPR is treated as a 
replicating its sign 

signed 
in the 

A register 
specified. 

specification 

procedure check occurs if 

V 

GPRO is 

8.10 SQUARE 

ROOT 




SQuare RooT 
SQRTR R 

Register 


* 


| OFA 

L _ 

' T 1 

1 R 1 

X_J 




0 

12 15 
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Square Root 


SQuare RooT Halfword 
SQRTH D (X , B) 

| 9 FA | X I B T D ] 

0 121620 31 


The 

operand 

is 

trea 

ted a s 

its 

sy ua re r 

oot 

. A ne 

gative 

if t 

he opera 

nd 

is neg 

ati ve. 

The 

operand 

for 

SQRTR 

is the 

is 

the mai 

n 

store 

ha Ifwo 

occu 

rs if th 

is 

halfwo 

rd is o 


a signed fraction 


specified GPR, wh 


an 


An 

odd 


alignment 

boundary. 


and replaced by 
ure check occurs 

ile for SQRTH it 
procedure check 
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Comparison Instructions 


9 COMPARISON INSTRUCTIONS 


9.1 ARITHMETIC COMPARES 


Compare Register with Register 
CRR R 1, R 2 

r- 1 -t- 1 

1 05 | R1 | R2 ] 

0 8 1 2 15 

Compare Register with Immediate 
CRI R1D,R1S,IH2 -or- R1,IH2 

\ 55 Trio Iris I ih2 1 

i_ j _i_i_i 

0 81216 31 


Compare Register with Halfword 
CRH R1,D2(X2,B2) 



Compare Register with Address 
CRA Rl,D2(X2,B2) 

f 75 T FI | X2 | B2 | 

i_ 

0 8 12 1620 


D 2 


-j 
3 1 


Compare Halfword with Register 
CHR D1(X 1 , B1), R 2 


| 95 1 R2 | XI | B1 | 

L_I_L_J_J- 

0 a 12 1620 


D 1 


_ j 

3 1 
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Comparison Instructions 


Compare Halfword with Immediate 


CHI D1 (XI,B1) ,IH2 

f B5 T////T XI T B1 T D1 T IH 2 | 

0 8 1 2 1 6 2 0 32 47 


Compare Halfword with Address 
CHA D1 (XI ,B1) , D2 (X2, B2) 


i 

I 

i _ 


C 5 


X2 | XI 

j 


1 2 


| B1 | D1 

16 2 0 


| B2 | D2 J 

32 36 47 


Compare Halfword with Halfword 
CHH D1 (X1,B1),D2(X2,B2) 

\ D5 | X2 T XI T B1 T D1 
0 a 12 16 2 0 


I B2 | 


32 36 


D2 




_j 

4 7 


The two operands are treated as signed numbers and compared 
(so that negative numbers are less than zero, which is less 
than positive numbers). The CFR is set as follows: bit 0 is 
set if the operands are equal; bit 1 is set if the first 
operand is greater than the second; or bit 2 is set if it is 
less. The summary flag is set on if they are equal, off 
otherwise. 

The following extended mnemonics are provided for branching 
after compares: Branch Equal (BE) , Branch Not Equal (BNE) , 
Branch Greater (BG), Branch Not Greater (BNG), Branch Less 
(BL), and Branch Not Less (BNL). 

Note that BH is not an extended mnemonic. BH is a mnemonic for 
Branch Halfword. 

The instructions allow the comparison of all possible 
combinations of lo-bit numbers in registers, immediate 
halfwords, addresses, or main store halfwords. 

An alignment procedure check occurs if a halfword is specified 
on an odd bounoary. 
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Logical Compaces 


9 i 2_LOGICAL_COMPAR£5 

Compare Logical Register with Register 


CL RR 

R 1 , R 2 

r 

| OB 

T T 1 

| R1 | R2 | 

i_ 

_L__j___j 

1 

1 

1 o 

i 

8 12 15 


Compare 

CLRI 

Logical Register- with 
R 1,1H2 

Immediate 

r 

| 5B 

1 R1 i////i IH2 

1 

___| 

0 

8 12 16 

3 1 

Compa re 
CLRH 

Logical Register with 
R 1, D2 (X2,B2) 

Halfwo rd 

r 

| 6B 

i_ 

1 R1 T X2 T B2 T 

__L _L_ . _ 1 i 

D2 | 

- j 

0 

a 12 16 2 0 

3 1 

Compare 

CLRA 

Logical Register with 
R 1, D2 (X2,B2) 

Address 

r 7 C 

i_ 

” t " r r r 

I R1 I X2 | B2 | 

1 __L 1 1 

D2 ] 

1 

0 

8 12 16 20 

3 1 

Compa re 
CLRB 

Logical Register with 
R 1, D2 (X2, B2) 

Eyte 

r 

| 8B 

i___ 

| R1 | X2 | B2 | 

1. X J. ... 

D 2 

0 

a 12 16 20 

3 1 

Compare 

CLHR 

Logical Halfword with 
D1 (XI ,B1) , R2 

Register 

r 

| 9 B 

i_ 

—r t t r 

I R2 | XI | B1 | 

D1 | 

0 

6 12 16 2 0 

3 1 


Rn Hu O* ct 
nr hr 
AH hvi 
"■A HA 


t 
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Logical Compares 


Compare Logical Byte with Register 


CLBR D1 (XI , B1) , R2 

[ AB | R2 | XI | B1 | D1 1 

L--L-J-1-L-J 

0 8 121620 31 


Compare Logical Halfword with Immediate 
CLHI D1 (XI,B1) ,1112 

^ BB T////T XI T B1 T D 1 T IH2 1 

0 a 121620 32 4 7 


Compare Logical Halfword with Address 
CLHA Dl(Xl r B1) ,D2(X2,B2) 


r 

1 CB 

i_ 

r TXT 

| X2 | XI | B1 J D1 

T 

| B2 

r 

| D2 

_ 

1 

1 

_J 

0 

8 12 16 20 

32 

36 

4 7 

Compare 

CLHH 

Logical Halfword with Halfword 

D1 (XI, B1) , D2 (X 2, B2) 



r- 

1 DB 

i 

I X2 | X1 | B1 1 D1 

i . j. i i 

- T- 

| B2 

i . 

1 D2 

4 , ..... . .. ... ... ..... 

“""I 

1 

,J 

0 

8 12 16 20 

32 

J 6 

4 7 

Compare 

CLBI 

Logical Byte with Immediate 
D 1 (XI ,B1) , IB2 

* 



r eb 

i_ 

7////T xi T bi T d i 

I////////I IB2 

1 

1 

_I 

0 

8 12 16 20 

32 

4 0 

4 7 


Compare Logical Character string with Character string 
CLCC D1 {XI ,B1) , D2 (X2, B2) , DL (BL) 

i i i i r i-r i i i 

J FB | X 2 J X1 | B1 | D1 | B2 | D2 | BL | DL | 


i z 


1 6 


2 0 


3 2 


5 2 


-J 
6 3 


0 


6 


3 6 


48 




















Logical Compares 


The two operands are treated as logical hit strings and 
compared in magnitude (so that zero is the smallest number). 
The CFR is set as for the other compare instructions. 

These instructions allow all possible combinations of 
byte-byte, half word-half word, and character string-character 
string comparisons. 

An alignment procedure check occurs if a halfword is specified 
on an odd boundary. 


9 
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10 BIT AND CHARACTER STRING INSTRUCTIONS 


10.1 OR 


Or Register with Register 
ORR Rl,R2 

f 08 T R1 T R2 | 

8 1 2 1 S 


Or Register with Immediate 

ORI R1D,R1S,IH2 -or- R1,IH2 

I-1-T- 1 -1 

| 58 |R1D |R1S | IH 2 | 

L_L_J_J_J 

0 81216 31 

Or Register with Haliword 
ORH R1,D2(X2,B2) 

r- 1 -t-t- 1 - 1 

| 68 | R1 | X2 | B2 | D 2 | 

O 8 121620 31 

Or Register with Address 
ORA R1,D2(X2,B2) 

| 78 1 R1 | X2 | B2 | D2 | 

O 8 121620 31 

Or Register with Byte 
ORB R1,D2(X2 r B2) 

I-1-T-T-T-1 

| 88 | R1 |X2 j B2 | D 2 | 

0 8 121620 31 


1*8 

ttn 

68. 

81 

Hr 

nr 




88 

W* 


86 






cc 
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Or Halfword with Register 


OH B D1 (X 1 ,Bl) , R2 

98 1 R2 | XI | B1 V" D1 ^1 

0 8 121620 31 

Or Byte with Register 
ObR D1 (X 1,B1) , R 2 

I A8 ]" R2 T XI T B1 T U1 

0 8 12 1620 31 


Or Halfword with Immediate 
OHI D1(XI,B1),IH2 

B8 I////I XI | B1 T” D 1 T IH 2 ] 

0 8 121620 32 47 


Or Halfword with Address 

Oil A D1 (XI, B1) , D2 (X2, B2) 


I 


C8 


T X2 | X1~T B1 7 

-J-x-J_L- 

8 12 16 20 


D 1 


B2 


D2 


32 


J 

3 6 


-J 
4 7 


Or Halfword with Halfword 
OHH D1 (X 1,B1) , D2 (X2,B2) 

| D8 | X2 T XI | B1 | D1 T B2 | 

i-1_ j-j_j _i_ j_ 

0 8 12 1620 32 36 


02 


I 


4 7 


Or Byte with Immediate 
OBI D 1 (XI, B1) , IB2 

E8 “T////7 XI T B1 T” D 1 T////////T IB2 ] 

0 8 121620 32 40 47 


Or Character string with Character string 
OCC D1 (X1,81),D2(X2, B2),CL (BL) 

I 1 I-1-1 I-1-1-1- 

1 F8 1X2 1X1 |B1 1 D1 |B2 | 02 |BL | DL | 

L-L-J-J_J-1_J_J_L-J 

0 8 12 16 20 32 36 48 62 63 
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Bit and Character String Instructions 

The two operands are treated as logical bit strings, and a 
boolean 'OR* is performed upon them. The result is placed in 
the first operand location. 

The instructions allow all possible combinations of byte-byte, 
halfword-naif word, and character string-character string 
operations. 

An alignment procedure check occurs if a halfword is specified 
on an odd boundary. 


10.2 AND INSTRUCTIONS 


The two operands are treated as logical bit strings, and a 
boolean 'AND' is performed upon them. The result is placed in 
the first operand location. 

The instruction formats are identical to those for the OR 
instructions, except that the operation code is X 1 *9 ' rather 
than X'*8'. Mnemonics are identical except for the first 
letter, which is "N" rather than "O'*. 

An alignment procedure check occurs if a halfword is specified 
on an odd boundary. 


10.3 EXCLUSIVE OR INSTRUCTION 


The two operands are treated as logical bit strings, and a 
boolean 'EXCLUSIVE OR' is performed upon them. The result is 
placed in the first operand location. 

The instruction formats are identical to those tor the OR 
instructions, except that the operation code is X'*A' rather 
than X ' *8 '. Mnemonics are identical except tor the first 
letter, which is "X" rather than “O". 

An alignment procedure check occurs if a halfword is specified 
on an odd boundary. 

\ 

10.4 TEST UNDER MASK INSTRUCTIONS 


The second operand is used as a mask to 
first operand. Each one bit in the 
corresponding bit in the first operand, 
follows: bit 0 is set if all selected 

mask is all zeroes; bit 1 is set if 


select bits in the 
mask selects the 
The CFR is set as 
bits are zero or the 
all selected bits are 
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one; or bit 2 is set if the selected bits are mixed zeroes and 
ones. The summary flag is set on if all selected bits are one; 
it. is set off otherwise. 

Extended mnemonics are provided for branching after a Test 
under Mask instruction; Branch all Zeroes (BZ), Brancn Not 
all Zeroes (BNZ), Branch all Ones (BO), Branch Not all Ones 
(BNO) , Branch Mixed (BM) , and Branch not Mixed (BNM) . 

The instruction formats are identical to those for the boolean 
instructions, except that the operation code is X'*C' rather 
than X'*8,9,A'. Mnemonics are identical except for the first 
letter which is "TM" rather than "0,N,X". Additionally, the 
TMCC instruction (for testing character strings) is not 
provided. 

An alignment procedure check occurs if a halfword is specified 
on an odd boundary. 


10 a 5_SCAN 


SCan Forward Equal to Addres 
SCFEA D 1 (XI,B1) , D2 (X2 , B 2) , DL (BL) 


r 

1 

L_ 

FC |X2 |X1 | B1 

_ _ i i . j 

T 

1 D1 

i 

T 

| 3 2 

i _ 

T 

| D2 

t 

] BL 

i i 

“1 
o 1 

' i 

I 

u - _J 

0 

8 12 16 

2 0 

32 

3 6 

4 8 

5 2 6 3 


SCan Backward Equal to Address 
SCBEA 01 (XI,Bl) , D2 (X2, B2) , DL (BL) 


I-T-T-T-1-1-T-1-T- 1 

| F 2 |X 2 |X1 |B1 | D1 |B2 | D2 |BL | DL | 

0 a 12 16 20 32 3b 48 62 63 


The first operand character string is scanned forward (left to 
right) or backward (right to left) for a character equal to 
that specified by the low-crder byte of the second operand 
address. If the character is found, bit 0 of the CFR is set 
on and GPR1 is set to point at that character in operand 1. 
If no such character is present, bit 1 of the CFR is set on 
and GPR1 is unchanged. The summary flag is set on if 
successful, off otherwise. 

Extended mnemonics are provided for branching after a scan; 
Branch Successful (BS), and Branch Not Successful (BNS). 

If the length is zero, the instruction always fails. 
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SCan Forward Not equal to Address 
SCFNA Dl (XI ,Bl) , D2 (X2, B2) , EL (BL) 


( FI 

|X2 |X1 

_j_i_ 

1 B1 

T 

1 Dl 

” T 

| B2 

L 

| D2 

a 

1 BL | 

DL 1 

0 

8 12 

1 6 

2 0 

32 

3 6 

4 8 5 2 

6 3 

SCan Backward Not 

equal 

to Address 




SCBN A 

Dl (X 1, B 1) ,D2 (X2,B2) ,DL(BL) 




1 F3 

1 

X 1 

-1 

1 

™ 1 
X 1 

1- 

1 B 1 

_i_ 

1- 

1 Dl 

_J_ 

T 

| B2 

_i_ 

" T ". 

| D2 

i i 

1 BL | 

1 

DL | 

0 

8 12 

1 6 

2 0 

32 

36 

4 8 5 2 

6 3 


The first operand character string is scanned forward (left to 
right) or backward (right to left) for a character not equal 
to that specified by the low-order byte of the second operand 
address. If an unequal character is found, bit 0 of the CFR 
is set on and GPR1 is set to point at that character in 
operand 1. If all characters are equal, bit 1 of the CFR is 
set on and GPR1 is unchanged. The summary flag is set on if 
successful, off otherwise. 

hxtended mnemonics are provided for branching after a scan: 
Branch Successful (BS), and Branch Not Successful (BNS). 

If the length is zero, the instruction always fails. 


SCan Forward using Table 

SC FT D1 (X 1, B 1) ,D2 (X 2, B2) ,DL(BL) 

f F4 Tx2 1X1 TbI T"Dl 7 b2 T D2 TbL T DL ] 

0 8 12 16 20 32 36 43 52 63 

SCan Backward using Table 

SCBT Dl (XI ,B1) , 1)2 (X2, B2) , CL (BL) 

\ F5 Tx 2 Txi "TbI T Dl T B2 T D2 Tbl T DL ] 

I_J-J-1_J_L-L_1_L-J 

0 8 12 16 20 32 36 48 62 63 


s 
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The first operand character string is scanned forward or 
backward a character at a time. Each character is used to 
select a byte from the second operand table. It this selected 
byte is zero, scanning continues. If this byte is non-zero, it 
is placed in GPRO and the address of the selector character in 
operand 1 is placed in GPR1. If the scan is successful, CFR 
bit 0 iand the summary flag are set on; otherwise CFR bit 1 
is set on and tne summary flag is set off (allowing use of the 
BS and BNS extended mnemonics). 

The second operand table is always 256 bytes long. Hence there 
is one table byte for every possible value of a character from 
operand 1. Table bytes are selected by taking the "n"th table 
byte if the value of the operand 1 character is "n". 

If the length is zerc, the instruction always fails. 


10.6 TRANSLATE 



TRanslate character string 
TR D1 (XI,B1) ,D2 (X2,B2) ,DL(BL) 

f FD 1x2 7X1 TB1 T D1 Tb2 \ 1)2 

0 a 12 16 20 32 36 


T-1-1 

|BL | DL | 

j_i_ j 

46 S 2 6 3 


The first operand character string is translated according to 
the 256-byte table specified by operand 2. Each character in 
operand 1 is scanned, its value , say "n", is used to select 
the correspoding "n"th byte in the table, which then replaces 
the old operand 1 byte. 

It the length is zerc, no translation is performed. 


10.7 INITIALIZE 


INITialize character string 
I NIT D1 (XI ,B1) , D2 (X2, B2) , EL (BL) 


\ FE 

L 

I X2 

1 

1 

1 - 1 

1 X | 

1- 1 

I 

T 

I B 1 

j 

T 

1 D1 

1, 

T T 

|B2 I D2 

i i 

T 

| BL 

1 

1 

1 

1 

1 O 

1 

8 

1 2 

1 6 

2 0 

3 2 3 6 

4 6 
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The first operand character string is in 
low-order byte of the operand 2 address. The 
string is filled with this byte. 

If the length is zero, no initialization is pe 


itialized to the 
whole character 

rformed. 



Subroutines and Interrupts 


11 SUBROUTINES AND INTERRUPTS 


Procedures were first mentioned in Chapter 3.1 -- how to write 
them and how they were controlled. This chapter gives a more 
detailed explanation, particularly in terms of how procedure 
calls are performed. 

A procedure call can occur for two reasons. First the programmer 
may reguest an explicit su broutine call via the CALL instruction. 
Secondly, the g-interpreter might force an implicit interrupt 
call when an interrupt request is detected. Both of these calls 
are performed in the same manner, so that a called procedure need 
not know whether it is a subroutine or an interrupt handler. 


11.1 THE STACK 


In order 
and to 
calls, a 
forma t: 


to maintain the correct sequence of procedure calls, 
save the contents of various registers across these 
save area s ta ck is employed. It has the following 


« 


1 - 

1 

SAVE AREA 

-1 

1 

1 

1 

_ L. - 

(N 

1 

1 

--1 

1 

SAVE AREA 

21 

1 — 

0 

1 

-4 


SP--> 0|current,| last | 

i- j _i 

0 8 15 


As a new procedure is invoked, it is assigned the next 
available save area on the stack. The save area number for 
the currently executing procedure is contained in the 
"current" byte. A save area is twenty halfwords long, and is 
used to save the general-purpose registers, PBR, PDR, CFR, 
and ICMR (see below) whenever a new procedure is called. When 
the procedure returns, they are restored, thus preserving 
their contents across the call. 

The "last" byte gives the save area number of the last 
useable save area on the stack. This helps prevent main store 
following the stack from being used indiscriminately. 
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Subroutines 


and 


Interrupts 


META 4B control register 20, the Stack Pointer (SP) , is always 
set to point at the stack ("current" byte) . This register 
should not be tampered with by the user. 


11.2 STACK CONDITIONS 


Certain special conditions concerning the save area stack can 
arise during program execution. These conditions require 
special 1 consideration (probably performed by a monitor 
program) and are described here. 


1 1. 2. 1 STACK OVER PLOW 


When the q-interpreter determines that a procedure being 
invoked will own the next-to-last save area, it considers 
stack overflow to have occurred. After invocation is 
complete, but before the first instruction of the new 
procedure is executed, a stack overflow procedure check 
will be forced. This allows a monitor program to allocate 
a bigger stack. 


11.2.2 STACK ESCAPE 


If the warning given by stack overflow goes unheeded, a 
procedure may eventually be invoked which can own no save 
area. If this procedure were to call another, or an 
interrupt call were to occur, stack escape would be 
recognized. In this case, the q-interpre ter goes into an 
infinite loop. 


Ui2 A 3_STACK_UN DERFLOW 


If an attempt is made to return from a procedure which owns 
the 0th save area, stack underflow occurs. A stack 
underflow procedure check is generated, and a monitor 
program can react as desired. 
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11.3 PROCEDURE CALLS 


CALL via 

Register 



CALLR 

R 



IS 

1 O 

1 

i 

1 

L- 

1 R 1 



i _ 

X J 



0 

12 15 



CALL via 

Address 



CALLA 

D(X,B) 



i — ' 

T l i 


-1 

| 7 FD 

1 X | B | 

D 

1 

_| 

0 

12 16 20 


3 1 

CALL via 

Halfword 



CALLH 

D (X , U) 



r 1 

| 9 FD 

1 X 1 B | 

D 

-1 

l 

i_ 

XXX 


j 


0 121620 31 


The operand specifies the address of a procedure to be. 

invoked. The following steps are taken by the g-interpreter: 

1. Check for stack, escape condition. 

2. Save general-purpose registers, PBR, PDR, CFR, and ICMR 
in current save area. 

3. Assign next save area to new procedure, and update 
"current" byte. 

4. Update PBR and GPR15 to point at new procedure, and set PDR 
to zero. 

5. Cause stack overflow procedure check if appropriate, or 
begin execution of new procedure. 

An alignment procedure check occurs if the procedure address 

is odd. 
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11.4 INTERRUPT CALLS 


An interrupt call is performed automatically by the 
g-interpreter when some special event occurs of which the 
software must be informed. The interrupt procedure is invoked 
almost exactly like a called procedure, except that its 
address cannot be provided by the programmer at the time of 
invocation. Instead, these addresses are obtained from the 
Stack p re fix, which resides below the stack in main store. 
The stack prefix contains pairs of halfwords, one for each 
interruption source. It has the following format: 


-4 | Extended Inst. | 

-8 | Self-interrupt J 

j.-, 

-12 | Procedure Check | 

j.-1 

-16 | META 4A \ 

J---J 

-20 | SIMALE | 

j- 

-24 | Vector General 1 

i- j 


The first halfword of each 
procedure to handle interrupts 
second halfword contains the 
during execution of the interr 


pair contains the address of a 
from that interrupt source. The 
ICMR which should be in affect 
upt procedure. 


The Interrupt Call Mask Register (ICMR), control register 19, 
contains bits which control the occurence of interrupt calls. 
It has the following format: 


ICMR 

i- t—t -r- t 

n/G bits m////|QQT| 

o a 1 3 i s 


Bits 0-8 are used to control 
and Vector General. When 
interrupt, one of these bits 
interrupt is ignored for th 
interrupt call is performed, 
later chapters. 


interrupt calls for¬ 
ever these units 
is checked. If it 
e time being. If 
More detail will be 


the META 4A 
request an 
is off, the 
it is on, an 
presented in 


Bits 13 and 14 are used by the g-interpreter and should never 
be set on by the user. 
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Interrupt Calls 

Bit 15 is the trace bit. See the META 4B q-interpreter 
listing for a description of this bit. 


The following steps are performed by the q-interpreter when an 
interrupt procedure is to be called: 


1. Check for stack escape condition. 

2. Save general-purpose registers, PBR, PDR, CFR, and ICMR 
in the current save area. 

3. Assign next save area tc new procedure, and update 
•'current" byte. 


4. Update PBR, GPR15, and ICMR from stack base, and set PDR to 
zero. 

5. Put interrupt designator in GPR6, and any interrupt 
information in GPR7 on up. 


6 . 


Cause stack overflow procedure 
begin execution of new procedure. 


check if appropriate. 


or 


The interrupt designator in Step 5 
the source of the interruption, 
information will be described in 
chapters. 


is a halfword specifying 
This and the interrupt 
detail in the appropriate 


I 


ft 
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11.5 PROCEDURE RETURN 


RETURN from procedure 
RETURN first,count 


| 5E |frst|frst| 

0 8 1216 


count 


_i 

3 1 


The RETURN 
procedure 
or interr 
preserved 
codes may 
number or 
"first" a 
zero, no 
The follow 


instruc 
and ret 
upted). 
across 
be retu 
regist 
rid "coun 
register 
ing step 


tion is used 
urn to the 
A set of 
this return, 
rned to the 
ers to be 
t" operands 
s are preser 
s are taken 


1. Check for stack underflow, 
it exists. 


to terminate the execution of a 
previously-executing one (caller 
general-purpose registers may be 
so that results or completion 
caller. The first register and 
preserved are specified by the 
, respectively. If the count is 
ved. 

by the q-int.erpreter: 

and cause a procedure check if 


2. Update "current" byte to specify previous save area. 

3. Restore general-purpose registers (except those to be 
preserved), and PBR, PDR, CFR, and ICMR. 


4. Continue execution in the previous procedure, 
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12 INTERNAL INTERRUPTS 


Interrupt requests can be divided up into two classes: internal 
and external. Internal interrupts originate from within the 
g-interpreter, and are necessary to indicate various exceptional 
programming requirements or errors. External interrupts are 
generated by units other than the META 4B, and are used to inform 
the B of special conditions in those units. 

This chapter deals with the three kinds of internal interrupts: 
extended instruction interrupts, self-interrupts, and procedure 
checks. 


12.1 EXTENDED INSTRUCTION INTERRUPTS 


Extended instructions are an optional facility useful for 
interfacing between a user's program and the monitor. They 
allow the user to code monitor requests in the normal 
instruction format, using otherwise invalid operation codes, 
and to nave these "invalid" instructions trapped and 
interpreted by software. This technique is extensively used 
in the META 4A. 

In order for an operation code to be considered extended 
rather than invalid, alterations must be made to a table in 
tiie q-interpreter. Given these alterations, the occurence of 
an extended operation code causes an immediate extended 
instruction interrupt call. The interrupt procedure will find 
the following information in its general-purpose registers: 

GPR6: X'0000’ 

GPR7: first halfword of instruction. 

GPRS: contents of q-interpreter register Al. 

GPR9: contents of q-interpreter register Dl. 

GPR10: contents of q-interpreter register A2. 

GPR11: contents of q-interpreter register D2. 

The contents of the four q-interpreter registers depends upon 
the format of the extended instruction. See the q-interpreter 
listing for mote detail. 
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1.2 A 2_S ELF-INTERRUPTS 


Sel£-INTerrupt via Register 
SINTR R 

r-r-1 

| 0 FE | R J 

i- j-1 

O 1 2 1 5 


SeIf-1NTerrupt via Halfword 
SINTH D (X, B) 

9 FE | X T B T~ D 
0 121620 


T 


1 


_I 

3 1 


Self-INTerrupt via Address 
SINTA D(X,B) 

!l 7FE T X T”B J D 

0 121620 31 


The self-interrupt 
explicit, means of 
execution of one 
self-interrupt call 
procedure receiving the 


instructions provide 
communicating with the 
of these instructions 
is performed, with 
following information: 


another, more 
monitor. Upon 
an immediate 
the interrupt 


GPR 6: X'0001 ' 

GPR7; instruction operand. 


12.3 PROCEDURE CHECKS 


A cursory description cf procedure checks was given in Chapter 
3.3. They provide a means for informing the user and/or 
monitor of programming errors. With each instruction 
description in this document, the possible procedure checks 
are noted. 

When a procedure check occurs, the PDR is backed up to point 
at tne instruction in error, and a procedure check interrupt 
call is forced. The interrupt procedure receives the 
following information: 

GPR 6: X'0002' 

GPR7: procedure check type code: 

0 - invalid operation code 
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1 - alignment 

2 - register specification 

3 - division by zero 

4 - SQRT operand negative 

5 - stack overflow 

6 - stack underflow 
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13 COMMUNICATION WITH THE META 4A 


13. 1 OVERVIEW 


Communication with the META 4A is a necessary 
performing multiprocessing tasks on BUGS, 
provided for interrupting each processor from 


ingredient for 
Facilities are 
the other, and 


for synchronizing execution via Di jkstra-like semaphores. 


13.2 THE UNIT CONTROL ELOCKS 


one processor 
Blocks (UCB) . 


Interrupting of 
tne Unit Control 
its UCB pointer is at locaticn X*3E 
table starts at locations X ' 3C ') . The 
UCB pointer is at location X'32'. The 
are as follows: 


by the other is controlled by 
The META 4A is unit 7; hence 


1 (since 
META 4B 
forma ts 


the. UCB pointer 


is 

of 


unit 1; 
the two 


its 

UCBs 


META 4A UCB 


0 \ l] 

2 | USH | 

i_i 

o is 


META 4B UCB 

i- 


I 1 

| USH 

*- 


0 
2 

---j 

4 | start-up PBR 

6 | start-up ICMR 
J-- 

8 ( start-up SP 


1 s 
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li*.i_«ETA_4A_iNTERRUPTS_META_4B 

The META 4A interrupts the B via the extended instruction 
INTB: 

INTB D (X, B) 

\ 6F T////T X T B T D ] 

0 a 121620 31 


The operand address is used as the interrupt code. There are 
two classes of interrupts: 


_2“INTERPRETER-HANDLED,INTERRUPTS 


If bit 0 of the interrupt code is on, the META 4B*s 
q-interpreter handles the interrupt and does not give it to 
the software. The only q-interpreter interrupt present now 
is code X'8000’. This is a start-up interrupt and causes 
the B to perform the following steps: 

1. Halt execution of any current program. 

2. Pick up the start-up FBR from its UCB, copy it into 
GPR15, and zero the PDR. 


3. 

Zero the CFR. 






4. 

Pick up the start-up 

ICMR 

and SP from its 

UCB. 



5. 

Begin execution of 

the 

new procedure. 

This 

is 

the 


method by which the 

META 

4A starts up a 

program 

in 

the 


META4B. 






1 3. 

3.2 SOFTWARE-HANDLED 

INTERRUPTS 





If bit 0 of the interrupt code is off, the q-interpreter 
will attempt to cause a META 4A interrupt call. Bit 8 in 
the current ICMR controls this call -- if it is on, then 
an interrupt call immediately occurs; if it is off, the 
interrupt remains pendinq. When the interrupt procedure 
receives control, the resgiters are loaded with the 
following information: 

GPR6: X'800 7' 

GPR7: the interrupt code 
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NOTE 0 Ah_ EEULLJf: Software interrupt codes are divided up 
into two classes for purposes of the monitor environment. 
Users should restrict their interrupt codes to the range 0 
to X'3FFF'. All codes above X*3FFF 1 are trapped by the 
monitor and not given to the user. 


13.4 META 40 INTERRUPT META 4A 


Tne META 413 interrupts the A via the instructions: 

INTerrupt A via Register 
INTAR R 

r- t-T 

| OFF | R | 

0 12 15 

INTerrupt A via Halfword 
INTAH D(X,B) 

r- t-T-1-1 

| 9 FF | X | B | D ] 

0 121620 31 


INTerrupt A via Address 
INTAA D (X , B) 

1-T-T-1-1 

I 7FF | X | B | D | 

0 121620 31 


The instruction operand is used as the interrupt code to the 
A. As with the 1NTB instruction, users should restrict 
themselves to codes between 0 and X'3FFF'. 


The methods by which 
procedures on tne A and 


the user actually specifies interrupt 
B is described in Chapter 17. 


.1 3._5_S RO NIZ AT10N_V IA_S EM APHORES 


Semaphores are a means of synchronizing execution of parallel 
processors. A semaphore on BUGS is a halfword in main store 
which is usually associated with a resource that both 
processors wish to use (e.g., a data structure). Bit 15 of 
this semaphore determines whether or not the resource is 
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free -- if it is off, the resource is free and can be used by 
a processor; if it is on, the resource is already in use. 

A typical sequence of code utilizinq a semaphore to control a 
resource would be as follows: 

1 . test bit 15 of the semaphore. 

2 . if on, repeat step 1. if off, set it on and continue. 

3. use the resource. 

4. reset bit 15 to zero 


Steps 1 and 2 must be performed so that the other processor 
cannot change the semaphore in between them. The 13 provides a 
special instruction to do this: 


SEMAphore 

SEMA D (X, B) 

| 9D | X 1 B "T D ] 

0 121620 31 


Bit 15 of the halfword operand is tested. If it is on, bit 1 
of the CFR is set; if off, bit 0 is set. The summary flag is 
set to reflect the on state. The bit 15 is then 
unconditionally set to one. The two steps are done with main 
store locked out, so that the A cannot tamper with the 
semaphore. 

If the semaphore address is odd, an alignment procedure check 
occu rs. 

Thus, to 

SEMA 
BT 

• use 
SZH 


use a resource on the B, the user codes: 
<semaphore> 

*-4 

the resource 
<semaphore> 


The same sequence would be coded on the A as: 

TSL <semaphore>+1,X* 01 * 

BO *-4 


• use the resource 
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LZ 


R2,<semaphore> 


with the TSL instruction performing the same duties as the 
SEMA. 
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15 VECTOR GENERAL 


1 5.1 (VEC TOR) GENERAL DESC RIPTION 


15. 1. 1 INTRODUCTION 


The Vector General (VG) is an I/O unit connected to the 
META 4B and capable of processing numerous types of 
graphical information. As its main function, it displays 
graphical data upon a Cathode-Ray Tube (CRT), not unlike an 
oscilloscope. This data is in the form of point, line and 
character specifications. Additionally, the VG is equipped 
with various interactive devices useful for inputting of 
information by the user. 


15.1.2 CRT DISPLAY UNIT 


The cathode-ray tube creates images by moving a beam of 
electrons across a glass face covered with phosphorus. 
This beam traces out the points and lines making up the 
image, as specified by orders to the VG control logic. It 
is necessary to draw the picture continually -- about 40 
times per second — to maintain a steady image without 
flicker. 


Each point on the scope face is represented by three 
coordinates: X and Y to select the position on the screen, 
and Z to select the writing intensity. +Z is considered to 
be in front of tne scope face, while -Z is behind it. It is 
possible for the user to work in two dimensions, 
maintaining a constant Z intensity, or to work in all three 
dimensions. 


A co 

ordi 

.nate 

is a 

12 - 

bit 

signed number 

treat 

ed 

as a 

fraction 

f rein 

-1.0 to +.99 

possi 

bie 

to i 

consider it 

an 

integer from 

alt ho 

ugh 

this 

can 

lead 

to 

problems. 

c on si 

sts 

of a 

4096 

X 4096 

X 4096 grid o 


Easter units. The cubic space created by t 
is called the scope or imajge space, with t 
located in the center of the scope face. 


, most commonly 
9. .. It is also 
-2048 to +2047, 
Thus our screen 
£ points, called 
hese coordinates 
he point (0,0,0) 
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15.1.2.1 VECTORS 


The VG is capable of drawing vectors from the current 
beam position to any specified point. These vectors can 
be blanked (that is, the beam can be turned off) or 
non-blanked, allowing both beam movement and drawing. 
Furthermore, a drawn line can be solid, dashed, dotted, 
or simply an end-point. 


RACTERS 

Characters can be drawn on the scope in tour different 
sizes. The character set consists of about 200 
graphics, represented by 8-bit ASCII codes. Appendix 3a 
contains a table of the character set. 

A character occupies a certain amount of space in the 
scope space, measured in raster units. The following 
table describes the four sizes: 


CODE 

ROWS 

COLUMNS 

WIDTH H 

EIGHT 



0 

60 

120 

34 

68 

. 00 * 

.017 

1 

40 

80 

50 

100 

. 0 1 z. 

>oi\ 

2 

30 

60 

68 

1 36 

. 0|7 

, 0 ^ 

3 

16 

32 

128 

256 

. Q$t 

.00 


(per 

screen) 

(raster 

un i ts) 




Certain ASCII codes perform control functions, 
carriage return or changing the character si 
characters are given symbolic names, w 
generated by the M4BEQUS macro if the argumen 
specified. 


Each ASCII code has an equivalent EBCDIC 
vice-versa (see Appendices 3a and 3b). Transla 
are available for converting these codes, 
generated as follows: 


such as 
ze. These 
hich are 
t "VG" is 


code and 
te tables 
and are 


TABLE ASCII-EBCDIC | EBCDIC-ASCI1 


15.1.3 INTERACTIVE DEVICES 


The VG is equipped with a veritable plethora of devices 
which can be employed by the user to input information. 
These devices are located on the table in front of the CRT 
display and are manipulated by the human hands. The 
following paragraphs describe these devices: 
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Joystick. The joystick is a small spring-loaded upright 
shaft with three degrees of freedom: left/right, 
back/forth, and twist. These are most commonly 
thought of as representing movement in the X, Y, and 
L dimensions, respectively. The analog settings of 
these three degrees of freedom are passed through an 
A/D converter, and are continuously available to the 
user as three 12-bit signed fractions. 


Dials. There are ten analog dials (numbered 1-10) on a 
small box connected to the VG. The analog settings of 
these dials are passed through an A/D converter, and 
are continuously available to the user as ten 12-bit 
signed fractions. 


Light Pen. The light pen is 
which can be held by the 
at the CRT screen, and 
frout of it, a signal 
appropriately enabled, this signal 
interrupt request to the META 4B. 


a small, pen-shaped device 
user. If the pen is pointed 
the electron beam passes in 
is generated to the VG. If 
can result in an 


The light pen is also equipped with a finger-activated tip 
switch, which can be used in conjunction with the pen 
to control interrupt requests. This is explained in 
greater detail below. 


Data Tablet. The data tablet is a flat tablet-sized device 
which can produce X-Y coordinates when tracked over by 
a stylus. In addition, if appropriately enabled, it 
produces interrupts to inform the user of the location 
of the stylus above the table surface. 


The data tablet is 
characters to 


good tor inputting free- 
the program. 


Keyboard. A 
available 
the phys 
the graph 
produces A 
by the cha 


rather com pi 
for inputting 
ical layout 
ics produced 
SCII character 
racter drawing 


x alphanumer 
characters. A 
of this 
by each key 
codes identic 
facility. 


If appropriately enabled, depression of 
interrupt request to the META 4D. 1 

key will cause a request every sixth o 

Function Keys. A panel of 33 function keys 
is available on the VG. Each key i 
which has the capability of being 
appropriately enabled, depression of 
causes an interrrupt request to the 
can then determine which key was 
special in that it will generate cont 
requests. 


form pictures or 


ic keyboard is 
ppendix 3c shows 
keyboard, with 
. The keyboard 
al to those used 


a key causes an 
f held down, any 
f a second. 

(numbered 0-32) 
s a small button 
illuminated. If 
a function key 
META 4B. The B 
hit. Key 32 is 
inuous interrupt 
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Any combination of function keys 0—31 (but not 32) can be 
illuminated by the user under program control. 


lb i 2_VG_REG1STER_FILE 


As mentioned in Chapter 2.2.4, the VG is eguipped with a 
register file, which can be. referenced with the XFER 
instruction. These registers vary in length from eight to 
twelve bits, but are always transferred in a 16-bit haltword, 
with relevent bits left-jus ti fied. 

The following paragraphs describe the register file. Each 
register is assigned a symbolic name by which it should be 
referenced. These names are defined by the M4BEQUS macro if 
the argument "VG" is given. In addition each register has a 
7-bit integer address. 


X COORDinate (VGXCOORD, 8) 

Y COORDinate (VGYCOORD, 9) 

Z COORDinate (VGZCOORD, 10) 

i-1 

| fraction | 

0 1 1 


These three registers always contain the 12-bit signed 
fractional coordinates of the current beam position. They can 
be fetched and loaded. If loaded, they cause the beam to 
move (not draw) to the specified position. This is useful for 
setting up initial image starting points. 


X SCALE (VGXSCALE, 17) 
Y SCALE ( V GY SCALE, 19) 

| fraction | 

L-J 

0 1 1 


These two registers are used to scale the X and Y dimensions 
of the image. The 12-bit signed fractions in these registers 
are niulti^lied times any X and Y image coordinates, 
respectively, before they are used for moving the beam. If a 
scale register contains a negative number, the image will be 
scaled and inverted in that dimension. 

Notice that the two registers are not contiguously numbered. 
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Z or Intensity Scale Register (VG1SR, 13) 


r-1 

| fraction J 

L_I 

o 1 1 




. uv 


JvVs 


'J* 


J.'*' 


6'^ “ 



When this register 
full, and all Z 
work in only two 

When this register contains 
with a *Z coordinate are 
those with a -Z coordinate 
coordinate, the dimmer it is 


writing intensity is 
allowing the user to 


a negative fraction, all points 
written at full intensity, while 
are gradated. The smaller the Z 
drawn. 


contains zero, the 
coordinates are ignored, 
dimensions. 


When this register contains a positive fraction, all points 
with a +Z coordinate are blanked, while those with a -Z 
coordinate are gradated. 


The magnitude of the ISR determines 
The bigger the ISR is in magnitude, 
occurs. 


the range of gradation, 
the more gradation that 


X Displacement (VGXDISP, 20) 
Y Displacement (VGYDISP, 21) 


| fraction | 

L_J 

0 t 1 


,r* 






1 A 


CW V 




■Ar V 

V M . _ 

#* I iS ^ 


j,o0' w 7 


?»• 


, 1 






0;’ 


\j 









These two registers are used tor displacing the image to be 
drawn. After scaling is performed, these 12-bit signed 
fractions are added to the resulting coordinates before they 
are used to move the beam. This can be used to display an 
image centered around a point other than (0,0). 


joystick 

X 

coordinate 

(VGJ0YX, 

67) 

joystick 

y 

coordinate 

(VGJOYY, 

68 ) 

joystick 

z 

coordinate 

(VGJOYZ, 

69) 

r 





( fraction 

1 



\ - 


-J 



0 


1 1 




These three registers contain the digitized 12-bit signed 
fractional values of the three joystick degrees-of-freedom. 
Storing int,o these registers is ignored. 


DIAL 1 value (VGD1AL1, 70) 
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DIAL 2 value 

• • • 

DIAL 10 value 
| fraction 1 

L_J 

0 1 1 


(VGDIAL2, 71) 
(VGDIAL10, 79) 


These ten registers contain the digitized 12-bit signed 
fractional values of each of the ten dials. Storing into 
these registers is ignored. 


data TABlet X coordinate 

i-1-1—i—T 

| fraction | // 11 |T | 

0 11 1415 


(VGTABX, 2) 


data TABlet Y coordinate (VGTAEY, 3) 


r---1 

| fraction | 

i_-j 

0 11 


The high-order 12 bits of 
digitized signed fractional 
circuits in the data tablet, 
contains two position bits: 


these two registers contain the 
values of the X and Y sensing 
In addition, the VGTABX register 


I: This bit is on when the stylus is less than one inch 

SSabove the tablet surface; it is off otherwise. 

T: This bit is on when the stylus is touching the tablet 

surface; it is off otherwise. 

If appropriately enabled, an interrupt request is made to the 
B whenever either of these bits changes. 

Storing into these registers is ignored. 


Mode Control Register (VGMCR, 5) 

111 i^i l[d|k|f{b j oTi 1 1 ll 

r_ 4 --J_j._j._ji-j 

0 124 4 56 78 11 


The L, D, K, and F bits control the light pen, data tablet, 
keyboard, and function keys, respectively. If a bit is off. 
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the corresponding device is entirely disabled. If it is on, 
use of the device will cause interrupt requests to the META 
413. 

The blink bit (B), if on, causes any image being displayed 
to blink nauseatingly every half second (bad karma). 

The remaining bits must be set as specified in the picture. 


Func tion 
Function 
Fu net ion 
Func tion 


Key 
Key 
K ey 
Ke y 


bits | 


_j 

7 


Lights 0-7 (VGFKLC, 0) 
Lights 8-15 (VGFKL8, 1) 
Lights 16-23 (VGFKL16, 52) 
Lights 24-31 (VGFKL24, 53) 


Tnese four registers contain a total of 32 bits, one for each 
of the function keys 0-31. Their status determines whether or 
not each key is lit. Function key 32 cannot be lit at will, 
but only lights when depressed. 

Notice that the four registers 
thus requiring two XFERS to set 


ke y 

32 

cannot 

be 

lit 

at 

are 

not 

contig 

uou 

sly 

nuin 

all 

the 

f uncti 

on 

Key 

lig 


15.3 CRT DISPLAY ORDERS 


Tne VG graphical facilities are controlled by special 
instructions, called or de rs, which are sent to the VG by the 


META 4B. These orders can modify the 
register rile, display lines and points, 
etc. VG orders can be generated at 
macros, or at run-time. The following 
them. 


contents of the VG 
display characters, 
assembly time using 
paragraphs describe 


15.3.1 NO-OPERATION AND SPECIAL ORDERS 


VGNOP 


[oocoT////////////] 

L_ L _J 

0 4 15 


VGSPEC [ DATA=<value> ][ , PBIT=NO+ J YES J 
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|P|010| value J 

I-L-J_J 

0 14 IS 


The VGNOP order perfoms no operation at the VG. 

The VGSPEC order serves the special purpose of allowing the 
user to generate an interrupt request to the META 4B. 
These interrupt requests are called P-bit interrupts and 
are activated by the presence of bit 0 in the order. 
Optionally, a 12-bit integer can be included in the order, 
specified at assembly time by the DATA argument. 

When a P-bit is encountered, the VG will stop accepting 
orders, and then will request an interrupt to the META 4B. 


l^il*.i_bQAD^ADU/A ND/0R_REG_V ALU ES 


VGLOAD/ADD/AN D/OR <first-reg>,<value1> ,...,<valuen> 

I op |////|trst-rgj 
i-a- l_j 

0 5 9 IS 


These orders can be used to modify the contents of 
registers in the VG register file. M n" 

contiguously-numbered registers are modified, starting 
with the one specified by <first-reg>. The registers are 
modified by replacing them with the values, adding the 
values to them, or ' AND’ing or ’OR'ing tne values with 
them. A value can be specified as a signed fraction, a 
decimal number from -2048 to +2047, a 2- or 3-digit 
hexadecimal number, or a symbol. 

These values are generated left-justified in "n" halfwords 
following the order. The low-order four bits of these 
halfwords are zero, except for the final halfword, in 


w h ich 

bit 

15 

m us 

t be 

on. 

lh is 

should be 

remembered if 

the 

last 

value 

is 

to 

be c 

hanged 

dynamically. 



Note 

t hat 

it 

is 

now 

possi 

ble 

to change 

VG registers 

with 

bot h 

the XFER 

i ns 

true 

tion a 

nd a 

display order. 
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15.3.3 ABSOLUTE AND RELATIVE VECTOR ORDERS 


VGABS/RLL [ «ODE=LINE* | DASHED | DOTTED | POINT] 
| 0001|//////|rnd| op | 

i-1-x_i_i 

O 4 1 0 1 2 1 5 

VGC <value>,<op>,<axis> 

J value |op|ax| 

i- j_j_j 

O 12 14 


These orders allow the user to draw vectors on the VG 
scope. Vector inode is entered by specifying a VGABS or 
VGREL order, which is followed by an arbitrary number of 
VGC coordinate specifications. 

VGABS mode causes absolute vectors to be drawn, that is, 
the user specifies absolute scope space coordinates. VGREL 
inode causes relative vectors to be drawn, that is, the 
user specifies coordinates which are relative to the 
current beam position just before the vector mode was 
entered. 


Vectors 
dotted 
the end 


can be drawn as solid (md=00) , 
(md=10) lines, or as simple 
of the vector) (md=11). 


dashed (md=01), or 
end-points (a dot at 


To specify the actual 
macro or generate the 
must specify actual 12 
pertain to the X, Y, 
used. Coordinate val 
fractions, integers 
hexadecimal numbers, o 
"X", "Y", or "Z". Coor 


vectors, the user can use the VGC 
in at run-time. In either case, he 
-bit coordinate values, whether they 
or Z axis, and how the/ are to be 
ues can be specified as signed 
frcm -2043 to +2047, 3-digit 
r symbols. The axis is specified as 
dinate operations are as follows: 


"L": The coordinate value is loaded (VGABS) or added 
(VGREL) to the specified coordinate register, but the 
beam position is not changed. 


••LM": The coordinate register is modified as with "L", and 
the beam is them moved to the position specified by all 
coordinate registers. 


"LD": The coordinate register 
the beam is then drawn to 
coordinate registers. 


is modified as with "L", and 
the position specified by all 
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"LDT": Operation proceeds 
drawing, the vector 
halfword is assumed to 
last operation i 

specifications. 


When building VGC half 
method is used; compute 
into the high-order 12 
the low-order four bits, 
bits. Mnemonic names are 
this purpose (if the "VG" 
" VGL" , "VGLM", "VGLD'?, 
and "VGX", "VGY", and " 
are 'OR'ed into a value 
set the appropriate bits. 

An example may clarify 
Suppose 1 wanted to draw 
the point (0,0) to th 
seguence could be used; 


as with "LD". In addition, after 
mode is terminated, and the next 
be a new order. "LDT" must be the 
n a list of coordinate 


words at run-time, the following 
the coordinate value and shift it 
bits of a work register, zeroing 
Then 'OR 1 in the <op> and <axis> 
provided by the M4BEQUS macro for 
argument is specified). They are 
and "VGLET" for the operations, 
VGZ" for the axis. If these names 
(with bits 12-15 oft), they will 


the use of VGC specifications, 
a 2-dimensional dashed line from 
e point (.4,.5). The following 


VGABS MODE=DASHED 
VGC 0, L, X 

VGC 0,LM,Y 

VGC . 4 , L,X 

VGC . 5,LDT,¥ 


lDj.3. 4 CHARACTER ORDER 


'| \f> 61 00 

VGCHAR [ SIZE=J.6X32+ | 30X60 J 40X80 | 60X120 | PREVIOUS] 

[,SLANT=HCRIZONTAL+ ) VERTICAL] 

i-r- t— i- t- 1 

|0001I////Is|siz11111) 

1-1_J L_I_I 

0 4 09 1215 


This order causes character mode to be entered. The 
character size can bo specified explicitly, or the size 
from the previous VGCHAR order can be used. It an explicit 
size is specified, the "siz" field contains a 1 followed 
by the size code. If PREVIOUS is used, it contains zeroes. 
The characters can be written horizontally (s=0) or 
vertically (s=1) (e. g. , for graphs). 

Following the order is an arbitrarily long string of ASCII 
character codes, one per byte, specifying the message to be 
displayed. This string can be of an odd or even length, 
but must end with the VGTERM control character. A macro is 
provided to generate ASCII character codes: 
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ASCII <string1>,...,<stringn> 

Each string is either a string of characters enclosed in 
pops (pops or ampersands within this string must be 
doubled), or a single character code. Single characters 
can be specified using the symbolic names generated by the 
M4BEQUS macro, or as any expression. 

The characters are displayed with the center of the first 
one lying at the current beam position. The beam position 
is updated as each character is displayed. 

Examples: 


VGCHAR 

SIZE = 4G X80 

ASCII 

'DOG ',* BONE 

ASCII 

' EAT ' , VGTERM 

VGCHAR 

SIZE=PREVIOUS 

ASCII 

M. • , VGCR 

ASCII 

• 2. ' ,VGTERM 


15.4 VG INTERRUPTS 


15.4.1 VG UNIT CONTROL BLOCK 


The VG is at unit address 9, and its UCD pointer is at 
location X'42', since the UCB pointer table begins at 
location X'30'. The g-interpreter expects the first two 
halfwords of the UCB to look as follows (the usual format): 


VG UCB 

9 ] 

| interrupt USH | 
0 is 


The contents of the USH is irrelevant. 


15.4.2 INTERRUPT SENSING 


Whenever an event occurs in the VG which causes an 
interrupt request to the META 4B, this tact is recorded in 
the B's VG Interrupt Register (VG1R) , control 
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register 24. This will in turn cause an interrupt call if 
enabled in the ICMR (see next section) . 

The format of the VGIR is as follows: 

VG1R 

r—r—i— t— i—i —t-1 

|P| C| L| D|K| FJ | 

< J—J 1 I J L_J 

012345 15 


P: 

C: 


L: 
D: 
K: 


F: 


if 

on, 

if 

on. 

sec 

ond 

drawn. 

if 

on, 

if 

on, 

if 

on , 

if 

on. 


a P-bit interrupt request has been made. 

the refresh rate clock has timed out a 40th of a 
signifying that another image frame can be 

a Light pen interrupt request has been made, 
a data tablet interrupt request has been made, 
a keyboard interrupt request has been made, 
a function key interrupt request has been made. 


Once an interrupt call has occurred 
request, the corresponding VGIR bit is 
q-interpreter. 


for an interrupt 
turned off by the 


I 


15 i 4 i _3_IN TERR (JP T_CA LL_C 0 N TRCL 


Various types of gadgets which can cause interrupt requests 
have been described above. At the VG end, these requests 
can be controlled by the VGMCR register. At the META 4B 
end, the ICMR can be used to control the occurence of 
interrupt calls for these requests. 

The high-order byte of the ICMR contains the following 
bits: 

ICMR , 

I 1 —T T—T —1 T—T—T-1 

|P|/|L|D|K|F|/|T| | 

1-L—I-1_I_I_I_ J _J_I 

01234567 IS 
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P: P-bit mask. If on, P-bit interrupt requests resulting 
from VGSPEC orders cause interrupt calls. If off, they 
do not, and the request remains pending in the VGIR. 


L: Light pen mask. If cn, the occurrence of light pen 
interrupt calls is controlled by the T Di t (bit 7). If 
the T bit is off, interrupt calls always occur. If the T 
bit is on, the calls occur only if the light pen tip 
switch is being touched (otherwise the interrupt request 
is discarded) . NOTE that a light pen interrupt call will 
occur each time the pen sees light for as long as the 
switch is touched. 


On the other hand, if the light pen mask is off, the light 
pen request remains pending. Note that once the 
interrupt call does occur, there will be no way to 
correlate the light pen position. 

D: Data Tablet mask. If on, data tablet interrupt requests 
cause interrupt calls. If off, they do not, and the 
request remains pending. 

K; Keyboard mask. If on, keyboard interrupt requests cause 
interrupt calls. If off, they do not, and the request 
remains pending. 

F: Function key mask. If on, function key interrupt 

requests cause interrupt calls. If off, they do not, 
and the request remains pending. 


When a VG interrupt call dccurs, the interrupt procedure 
receives the following information: 

GPR6: X'8009' 

GPR7: The ICMR bit number of the type of interrupt (0 
for P-bit, 2 for light pen, 3 for data tablet, 
4 for keyboard, or 5 for function keys). 

GPR8: Special information depending upon the type of 

interrupt. For keyboard interrupts, it 

contains the ASCII character code in bits 
8-15, zeroes in bits 0-7. For function key 
interrupts, it contains the function key 

number (Q*32). For the other interrupts, it 
contains cruft. 


? 
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16 ET CETERA INSTRUCTION 


16.1 INTRODUCTION 


ll>ilil_MTION AL E 


In the preceeding chapters we have described the SIMALE and 
the Vector General. In each case, a (perhaps complex) 
data structure is needed to contain the data information to 
be interpreted by these units. In the case of the SIMALE 
the data might be coordinates, characters, or 
floating-point numbers. For the Vector General, the data 
is a linear sequence of orders specifying a display image. 
The question wnich remains is: how do we provide this data 
to these units? 

The ET CETERA (ETC) instruction gives us this capability. 
When an ETC is executed, the META 4B q-interpreter goes 
into a special mode in which it acts as an interface 
between the user-specified data structure and the SIMALE 
and/or Vector General. It directs the interpretation of 
the data structure at the highest level, extracting 
information and trjcist'erring it to and from these units. 


16.1.2 ETC REGISTERS 


In order for the user 
interpretation of the 
registers is used, 
also referenceable as 


and the q-interpreter to control 
ETC data structure, a set of six 
These are the ETC registers 32 
local store locations 32-47. 


the 

teen 

-47, 


Some of these registers are set up by the user before 
issuing an ETC instruction -- these registers specify the 
wnereabouts of the data structure to be interpreted. The 
q-interpreter updates these registers as it extracts 
information from the structure. 


Each ETC 
symbolic 
usual. 


register will be described below. They are given 
names which are defined by the M4BEQUS macro, as 
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16.1.3 ETC INSTRUCTION 


ET Cetera 


ETC name 

,-T-T- 

I OF J////////I name 

0 8 16 


-1 

I 

— J 
3 1 


The ETC instruction 
structure to begin. 
The halfword name 
ETCNAME register, 
identifying which 
should be aborted 
check) . 


causes interpretation of the user data 
as specified by certain ETC registers, 
is loaded into ETC register 47, the 
This gives the user a means of 
ETC instruction was executing if one 
for any reason (such as by a procedure 


1b.2 ETC DATA STRUCTURE 


16.2.1 DATA AREA 


The data structure for an ETC instruction lies within an 
area of main store called a da ta area. Although this data 
area resides in a specific place in main store, all 
pointers to or addresses of items within this area are 
ESl^tive to the start of the area. Thus the first byte in 
the area is relatively addressed as byte 0, while the 100th 
halfword would be addressed as byte 198. 


The purpose of relative addressing is to provide the user 
an easy and efficient means of relocating his data 
structure without changing the actual data. An example is 
when she writes a data area out to disk and reads it Dack 
into a different place in main store. 

When a data area is to be used initially by an ETC 
instruction, its address (absolute) must be placed in the 
Data Base Register (DBR), ETC register 32. 


A data area can be created at assembly time by coding the 
following macros: 


[<labela> ] 
• (info 
[ <labelb> ] 


DATA 

within data 
ENDDATA 


area) 
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If the user wishes to use absolute pointers within the data 
area (i.e., relative to absolute location 0), the label on 
the DATA macro should be ommitted. This is useful if the 
data is to be built at run time, but not saved. 


16.2. 2 BLOCKS 


Within the data area, 
arranged in a linked 
composed of three parts: 


information to be interpreted is 
ring of blocks. Each block is 


1 . 


The block header. The header contains two halfwords, 
the first of which contains a relative pointer to the 
next block in the ring. The second halfword can be used 
for any purposes desired by the programmer (a typical 
use might be tor a relative pointer to the previous 
block, making the data structure a doubly-linked ring). 


2. A set of sub-blocks. It is the sub-blocks which contain 
the actual data to be interpreted. An arbitrary number 
of sub-blocks can reside in each block. 


3. A halfword containing zero. This marks the end of the 
block. 

Before an ETC instruction can be issued, the Block Pointer 
(BP) (ETC register 33) must be initialized with the 
relative address of the initial block to be interpreted 
within the data area. 

A block can be created at assembly time by coding the 
following macros: 

<labeia> BLK next-blk[,PREV=<blk-label> | 

SECON D=<value>] 

• (info within block) 

[<labelb> ] ENDBLK 

<next-blx> is the label on the BLK macro for the next block 
in the ring. If the second header halfword is to be used, 
it can be specified as a relative pointer (PREV=) or as an 
absolute value (SECOND=). 
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16.2.3 SUB-BLOCKS 


Sub-clocks are the entities containing the actual data to 
be interpreted. A sub-bicck resides within a block, and 
consists of two parts: 

1. The sub-block header. This header is two halfwords long, 
and the tirst halfword certains the length (in bytes) of 
the sub-block, i*!£i!idinc[ the four bytes of header. A 
sub-block may be odd in length, in which case the extra 
byte after the end is ignored. The second halfword 
contains information specifying how this sub-block is to 
be interpreted. If bit 0 is off, then this sub-block is 
to be interpreted by the SIMALE, and the remaining bits 
contain SIMALE initialization information. if bit 0 is 
on, then this sub-block contains only orders to be sent 
directly to the Vector General. 

2. Sub-block data. Following the header is the data to be 
interpreted by the SIMALE or the orders to be sent to 
the Vector General. 

Before an ETC is issued, the Sub-Block Pointer (SBP) (ETC 
register 34) must be set to contain the relative address 
of the initial sub-block (within the initial block) to be 
interpreted. This is usually the first sub-block in the 
initial block. 

A sub-block can be created at assembly time by coding the 
following macros: 

[<labela> ] SUBLK <simale-init> | VG 

• (data within sub-block) 

[<labelb> ] ENDSUBLK 

The argument to SUBLK is either SIMALE initialization 
information or the tag "VG". The sub-block length is filled 
in automatically. 

N.QTE.1 The SUBLK macro generates labels in the form SUBn 
(n= 1, 2, 3...) . The user should avoid using such labels. 


16 i 2 i 4_ETC_1NSTRUCT10N_EXECUTION 


When an ETC instruction is issued, after setting up the 
DBR, BP, and SBP, execution proceeds as follows: 

1. Starting with the initial block and sub-block, 
interpret all the sub-blocks in each block, switching 
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to new blocks each time the ending zero halfword is 
encountered. 

2. It, while interpreting, an error condition should arise 
(e.g., an odd next-block offset), abort execution and 
cause the appropriate procedure check. 

3. Otherwise, if a META 4A, SIMALE, or Vector General 

interrupt call is required (e.g., due to an 

enaoled light pen hit), abort execution so that it may 
occur. 

4. Otherwise, if none of the above occur, display the 
entire data ring exactly once, and then abort. 

Whenever we abort ETC execution, the BP and SBP will be 
updated to point at the n ex t block/sub-block that would 
have been displayed had we not aborted. This means the 
programmer has tc set up these registers only once, and 
then can issue multiple ETCs (perhaps in a loop). Each 
successive ETC will take up wherever the previous one left 
off. 

Furthermore, four other ETC registers will be set to 
indicate where we were interpreting when the abort 
occurred. These are the Final Data Base Register (FDBR), 
Final Block Pointer (FBP) , Final Sub-Block Pointer (FSBP), 
and Final Data Pointer (FDP), ETC registers 40-43. These 
can tell the programmer in which data area, block, and 
sub-block the abort occurred, plus which halfword was the 
last one interpreted. The FDBR contains an absolute 
address, while the others are relative to it. 


2b 2.3_VECTOR_GEN ERA L_ SUB-BLOCKS 


During interpretation of Vector General sub-blocks, the ETC 
instruction may be aborted due to errors or the completion of 

one circuit of the block ring. In addition, if a P-bit or 

light pen interrupt request is recognized, interpretation 
will be immediately aborted so that an interrupt call can 
occur. Keyboard or fun ction key interrupts will not abort -- 
they are left pending during ETC execution. 

After an abort due to a P-bit request, the FDP will point at 
the VGSPEC order in question. After one due to a light pen 
hit, the FDP will be accurate if a vector was being 

displayed, but may be off by one or two halfwords if 

characters were. 
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16.4 THE CLOCK INSTRUCTION 


Clearly, one of the principal uses of the ETC instruction is 
to perform graphical data manipulation and display. When 

using the Vector General scope, it is necessary to ensure that 
simple images are not displayed too often. For example, if 
an ETC instruction were to be used to display a single dot, 

and this ETC were to be put in a tight loop in order to 

maintain the image, a wonderful burned spot would soon appear 
in the phosphorus. 

As explained in Chapter 15.1.2, the Vector General has a 
refresh rate clock, which pulses 40 times per second. No image 
should be displayed more often that this. Hence the 

programmer needs an instruction which pauses until the next 
clock pulse: 


CLOCK vector general 
CLOCK 0 

! 8E I //////////////// ///////7l 

i- j _j 

OS 3 1 


A CLOCK instruction should appear at the top of every display 
loop using ETC. 


16,5 A TYPICAL DIS PLAY SEQUENCE 


The following is an outline of a typical sequence employing 
the ETC instruction to display an image upon the Vector 
General: 

set up initial DBR, EF, and SBP 
LOOP CLOCK 0 

update dynamic portion cf data structure 
ETC 0 

test for terminate conditions 
GOTO LOOP if not satisfied 
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17 RUNNING META 4B PROGRAMS -- MULTIPAC 


When running programs on BUGS using the META 4B, a monitor is 
needed to control such things as META 4A/B communication, META 4B 
interrupts, main store ailocaticn by the META 4B, etc. This 
monitor is called MULTIPAC, and is controlled by the user via the 
MULTI macro. 

Two modes of programming are available with MULTIPAC: 

1. RUNB mode. In RUNB mode, it is assumed tnat the user wants 
to write code only for the META 4B; no A programs will be 
present. A "null" A program is provided which will load and 
execute any such B program. 

2. Normal mode. In this mode, the user writes both A and B 
programs, and they communicate via g-in terpreter and MULTIPAC 
facilities. 


17.1 RUNB MODE 


In RUNB mode, the user writes code only for the META 4B. The 
mainline B program must use the MULTI macro to set up an 
operating environment and to specify Vector General interrupt 
. handling options, if required. This macro should be the 
first thing executed in the mainline and is coded as follows: 


MULTI META4B[ , V G1NT=< procn> 

[,ICMR=(P-OIT+, 

LIGHT-PEN+, 
DATA-1ABLET+, 
KEYBOARDS 
FUNCTION-KEYS+, 
TIP-SWITCH+, 

M ETA-4A + ) 

[ ,VGMCR=(LIGHT-PENS 

DATA-TABLET + , 
KEYBOARD+, 
FUNCTION-KEYS+, 
BLINK) ] ] ] 


If Vector General interrupts 
argument specifies a proced 
argument specifies which and 
enabled in the B's ICMR. T 
type of interrupts or cpti 
register. Any combinations 
allowed. 


are to be accepted, the VGINT 
ure to handle them. The ICMR 
how interrupt calls are to be 
he VGMCR argument specifies the 
cn to be enabled in the VG MCR 
of keywords, in any order, is 
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Upon return from the 
as specified by the 
changed later if the 


MULTI macro, interrupts will be enabled 
ICMR and VGMCK options. Enabling may be 
user so desires. 


When the mainline B program determines that execution is 
complete, the following macro should be executed to terminate 
processing: 


RUN BOON E 


This generates code to inform MULTIPAC of completion and to 
return from the B mainline. 


When you are ready to run a program in RUNB mode, generate a 
BUGS KODU file under CMS using tne G MS LIN K command. 

Once the MOUU is on the BUGS disk, it can be run with the 
following GMS command: 

RUNB <modu-narae> 

A sample RUNB mode program is shown in Appendix 4a. 


17.2 NORMAL MODE 


In normal mode, the user writes programs for both macnines, 
which can communicate using the facilities described in 
Chapter 13. When a normal mode program is executed, the A 
mainline gets control first. It must then start up a B 
mainline, which will run in parallel with it. To do this, 
another version of the MULTI macro is used: 


o <v> 


X\V> ^ 
Cf % 




VP 


,v<r 


MULTI 


START,M4 BPROC= <procu> 

[ ,M4BINT=<proca> 

[ ,MAXUSH=<expression> ] ] 


k 


The M4BPR0C argument specifies the address of the B 
If B interrupts are to be accepted by the A (these 
generated by an INTA instruction), M4BINT speci 
address of an A procedure to handle them. The MAXUSH 
can be used to set a limit on the interrupt code, so 
codes above this limit are discarded. The default 


mainline. 

would be 
fies the 
argument 
that all 
limit is 


X'3FFF'. 


The M4BINT procedure, if present, must 
return with a RET. The interrupt code 
register 2 upon entry. 


begin with an ENT and 
from the B will be in 


Additional arguments are available on the MULTI 
to specify handling of A interrupts. These are: 


META4B macro 
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MULTI META4B,...[ ,M4AINT=<procn> 

[,MAXUSH=<expression> ] ] 

If A interrupts are to be accepted by the B (these would be 
generated by an INTB instruction), the M4AINT argument 
specifies a procedure to handle them. The MAXUSH argument 
corresponds to the one on the MULTI START macro. 

The M4AINT procedure, if present, must be a standard B 
procedure. The interrupt code from the A will be in GPR7 upon 
entry. 

When the mainline A program determines that execution is 
complete, it should issue the following macro before POSTing 
GMS and RETurning: 

MULTI DONE 


On the other hand, when the mainline B program desires to 
1 complete, all it needs to do is RETURN. The two mainline r must 
complete; they may complete in any order -- MULTIPAC waits 
until they are both finished. 

A and B programs may cf course be GMSLINKed into the same MODU 
files, and they may refer to each other via V-constants. 

A sample normal mode program is shown in Appendix 4b. 


17.3 MAIN STORE CONTROL IN THE B 


As in the A, a user of the B can allocate and tree blocks of 
main store. An allocated block is always aligned on a 
halfword boundary, and is always a multiple of four bytes in 
length. To allocate a block, the B user codes: 

MULTI ALLOCATE,SIZE=<size>,ADDRESS=<gpr> 

The <size> can be specified as an XBD address or as a GPR in 
>|c parenthases. This size is rounded u£ to a multiple of four, 
space is obtained from main store, and its address is returned 
in the GPR specified by the ADDRESS argument. If space is not 
available, an address of zero is returned. 


When the user no longer needs this allocated space, 
be f reed . To do this, the user codes: 


it should 


MULTI FREE,ADDRESS=<gpr>,SIZE=<size> 

The size is again rounded, and the secified block is 
dealloca ted. 
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17.4 GMS SVCS FROM THE B 


MULTIPAC provides a facility which allows the user to execute 
GMS SVCs from the B. Thus the user could execute commands, 
manipulate tiles, or read cards- from the B. This is 
especially useful in RUN B mode. To do this, one codes: 

MULTI GMSVC,SVC=<expression>,ARGLIST=<label>, 

W A IT = YES + | NO 

The SVC specified by the SVC argument is executed, using the 
argument list specified by ARGLIST. This argument list should 
be identical to the one used on the A. 


In order to 
W AIT=Y ES, 
(WAIT-NO) . 


wait for completion of the SVC, the user can code 
or can test for completion later in the program 
To test for completion, code: 


WAIT <argl ist-label> 

This loops until the WCh is POSTed by the A 






The Fudd Debugging Package 


iS_TllE_FUDD_D£BUGGING_PACKAGE 


The FUDD debugging package is described in a separate document 
entitled "FUDD: Interactive Debugger Users* Guide". 
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Metalinguistic Symbols 


AP£ENDIX_0: d_ETA LINGUIST IC_SYMBCLS 


• Syntactic constants are specified in upper-case letters. 

• Syntactic variables are enclosed in angle brackets (" <" and 
">"), and named using lower-case letters. 

• Optional items are enclosed in square brackets (•'[ " and " 

• The minimum abbreviation for a keyword is underscored. 

• Defaults are specified by following them with a superscript 
plus sign { M •*■") . 

• Syntactic variables followed by a box ("a") are special 
address specifications. They can be coded as a label, a 
V-constant, or a register in parenthases. 





Appendix 2a - Instructions by Mnemonic 
A£EJWDIX_2Ai_INSTRUCTIONS BY MNEMONIC__ 


SETS 


MNEMONIC 

OPCODE 


PAGECFP 


ABSH 

9E6 


NO 

41 

ABSR 

0F6 


NO 

4 1 

AHA 

C 1 


YES 

43 

A Htl 

D1 


YES 

43 

A HI 

B 1 


YES 

43 

A HR 

91 


YES 

42 

ARA 

71 


YES 

42 

A Rli 

6 1 


YES 

42 

AR1 

51 


YES 

42 

ARR 

C 1 


YES 

42 

- B 

4 


NO 

22 

- BC 

5D8 

I 

NO 

43 

- BCF 

5D 


NO 

24 

-BE 

5D8 

2. 

NO 

51 

'BE 

2 


NO 

24 

-BG 

5D4 

5> 

NO 

5 1 

-BH 

9 FC 


NO 

22 

"B L 

5D2 

V, 

NO 

51 

-BM 

5D2 

J 

NO 

58 

BN 

5 D2 

* 

NO 

38 

-BNE 

5 D6 

1 

NO 

51 

-BNG 

5DA 


NO 

51 

'BNL 

5 DC 


NO 

51 

"BNM 

5DC 

its 

NO 

58 

- BNN 

5 DC 

»* 

NO 

38 

BNO 

5 DA 

u 

NO 

58 

- BNP 

5 DA 

•J 

NO 

38 

BNS 

5D4 

P 

NO 

52 

BNZ 

5D6 

M 

NO 

38,58 

-BO 

5D4 

)h 

NO 

43,58 

-BP 

5 D4 

! V 

NO 

38 

- BR 

0 FC 


NO 

22 

BS 

5D8 

it 

NO 

58 

* BT 

3 


NO 

24 

BZ 

5D8 


NO 

38,58 

CALLA 

7FD 


NO 

64 

CALLH 

9FD 


NO 

64 

CALLR 

OFD 


NO 

64 

CASE 

6D 


NO 

25 

CHA 

C5 


YES 

51 

CHH 

D5 


YES 

5 1 

CHI 

B 5 


YES 

51 

CHR 

95 


YES 

50 

CLBI 

EB 


YES 

53 

CLBR 

AB 


YES 

53 

CLCC 

FB 


YES 

53 

CLHA 

CB 


YES 

53 

CLHH 

DB 


YES 

53 

CLHI 

BB 


YES 

53 
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CLHR 

9B 

YES 

52 

CLOCK 

BE 

NO 

9 5 

CLR A 

7B 

YES 

52 

CLRB 

8 B 

YES 

52 

CLRH 

6 B 

YES 

52 

CLRI 

5 B 

YES 

52 

CLRR 

C-B 

YES 

52 

CRA 

75 

YES 

50 

CRH 

65 

YES 

50 

CRI 

55 

YES 

50 

CRR 

05 

YES 

50 

DDTSH 

9F5 

YES 

40 

DDT SR 

0F5 

YES 

40 

DRA 

74 

YES 

47 

DRH 

64 

YES 

47 

DRI 

54 

YES 

4 7 

DRR 

04 

YES 

47 

DTSH 

9F4 

YES 

40 

DTSR 

0F4 

YES 

40 

ETC 

6 F 

MUNG 

9 1 

EXSR 

0F9 

NO 

48 

IDLE 

8 D 

NO 

* ** 

IH 

9F2 

NO 

39 

IIH 

9F3 

NO 

39 

HR 

0F3 

NO 

39 

I KIT 

FE 

NO 

60 

I NT A A 

7FF 

NO 

7 3 

INTAH 

9 FF 

NO 

73 

INTAR 

OFF 

NO 

73 

IR 

0F2 

NO 

39 

L5HDI 

16 

YES 

34 

LSHDR 

IE 

YES 

34 

LSHI 

14 

YES 

33 

LSHLDI 

12 

NO 

37 

LStiLDR 

1 A 

NO 

37 

LSHL1 

10 

NO 

36 

LSHLR 

18 

NO 

36 

LSHR 

1C 

YES 

33 

MR A 

73 

NO 

45 

MRH 

63 

NO 

45 

MRI 

53 

NO 

45 

MRR 

03 

NO 

45 

NDI 

E9 

NO 

57 

NBR 

A 9 

NO 

57 

NCC 

F9 

NO 

57 

N EGH 

9F7 

NO 

4 1 

N EG R 

0 F7 

NO 

4 1 

N H A 

C9 

NO 

57 

NHH 

D9 

NO 

57 



N HI 
NHR 
NOP 
NR A 
NRB 
NRH 
NRI 
NRR 

OBI 

OBR 

OCC 

OHA 

OHH 

OHI 

OUR 

ORA 

ORB 

ORH 

ORI 

ORR 

R El 
RBR 
RCC 

RETURN 

RH A 

RHH 

RHI 

R HR 

R R A 

RRB 

R RH 

RRI 

RRR 

RSHDI 

RSHDR 

R S HI 

RSHLDI 

RSHLDR 

R S HLI 

RSHLR 

R S HR 

SCBEA 

SCBNA 

SCBT 

SCFEA 

SCFNA 

SCET 

SEHA 

SHA 

SHH 

SHI 

SHR 
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B 9 

NO 

57 

99 

NO 

57 

o no 

NO 

22 

79 

NO 

57 

89 

NO 

57 

69 

NO 

57 

59 

NO 

57 

09 

NO 

57 

E 8 

NO 

5b 

A8 

NO 

56 

F8 

NO 

5b 

C8 

NO 

56 

D8 

NO 

56 

B8 

NO 

56 

98 

NO 

56 

78 

NO 

55 

88 

NO 

55 

68 

NO 

55 

58 

NO 

55 

08 

NO 

55 

E6 

NO 

29 

A6 

NO 

29 

F 6 

NO 

29 

5E 

NO 

67 

C6 

NO 

29 

D6 

NO 

29 

B6 

NO 

29 

96 

NO 

28 

76 

NO 

28 

86 

NO 

28 

66 

NO 

28 

56 

NO 

28 

06 

NO 

28 

17 

NO 

35 

1 F 

NO 

35 

15 

NO 

33 

13 

NO 

37 

1 B 

NO 

37 

1 1 

NO 

36 

19 

NO 

36 

ID 

NO 

34 

F 2 

YES 

58 

F3 

YES 

59 

F5 

YES 

53 

FO 

YES 

58 

FI 

YES 

59 

F4 

YES 

59 

9 DO 

YES 

74 

C2 

YES 

44 

D2 

YES 

44 

B2 

YES 

44 

92 

YES 

44 



SIMALE 

SINTA 

SINTH 

SINTR 

SOH 

SOK 

SQRTH 

SQRTR 

SRA 

SRH 

SRI 

SRR 

SWBR 

SHHH 

SWHR 

SWRB 

SWRH 

SWRR 

S2H 

SZR 

TMBI 

TMBR 

TM HA 

TMHH 

TMHI 

TMHR 

TMR A 

T MR B 

TMRH 

TMRI 

TMRR 

TR 

TSA 

TSH 

T SR 

XBI 

X BR 

XCC 

XFER 

X H A 

XHH 

X HI 

XHH 

X R A 

XRB 

XRH 

XRI 

XRR 
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5F 

NO 

# * * 

7FE 

NO 

69 

9 FE 

NO 

69 

0 FE 

NO 

69 

9 F 1 

NO 

26 

0 F 1 

NO 

26 

9 F A 

NO 

49 

OFA 

NO 

48 

72 

YES 

44 

62 

YES 

44 

52 

YES 

44 

02 

YES 

44 

A7 

NO 

31 

D7 

NO 

31 

97 

NO 

31 

87 

NO 

31 

67 

NO 

31 

07 

NO 

31 

9 FO 

NO 

26 

0F0 

NO 

26 

EC 

YES 

57 

AC 

YES 

57 

CC 

YES 

5 7 

DC 

YES 

57 

BC 

YES 

57 

9C 

YES 

57 

7C 

YES 

57 

8 C 

YES 

57 

6C 

YES 

57 

5C 

YES 

57 

OC 

YES 

57 

FD 

NO 

60 

7F8 

YES 

38 

9F8 

YES 

38 

0F8 

YES 

38 

EA 

NO 

5 7 

AA 

NO 

57 

FA 

NO 

57 

FF 

NO 

19 

CA 

NO 

57 

DA 

NO 

57 

BA 

NO 

57 

9 A 

NO 

57 

7 A 

NO 

57 

8 A 

NO 

57 

6 A 

NO 

57 

5A 

NO 

57 

0 A 

NO 

5 7 
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APPENDIX_2Bl_INSTRUCT10NS_BY OPERATION CODE 






SE1S 


CP 

CODE 

MNEMONIC 

CFR? 



0 1 

ARR 

YES 



02 

SR R 

YES 



03 

MR R 

NO 

00 


04 

DRR 

YES 

QOX 


05 

CRR 

YES 

OE 


06 

RRR 

NO 

0! B 


07 

SWRR 

NO 


08 

ORR 

NO 

so 


09 

NRR 

NO 

S'? 


OA 

XRR 

NO 

5PE 


OB 

CLRR 

YES 



OC 

TMRR 

YES 

Gg 


0D0 

NOP 

NO 

P 


0F0 

SZR 

NO 

'll 


ofi 

SOR 

NO 

~/D 

*7G 


0F2 

IR 

NO 

”?F V 


0F3 

HR 

NO 


0 F4 

DTSfi 

YES 

S'* 


0F5 

DDTSR 

YES 

£■« 


0F6 

ABS 8 

NO 

fa 


0F7 

N EGR 

NO 

ts 


0F8 

TSR 

YES 



0 F9 

EXSR 

NO 



OFA 

SQRTR 

NO 

c ;v 


0 FC 

BR 

NO 

9o to 

OFD 

CALLR 

NO 



0 FE 

SINTB 

NO 

9f P 


OFF 

INTAR 

NO 

,A£? 



, 


A f 
fii 


10 

LSHLI 

NO 



1 1 

RSHLI 

NO 

Am 

P* 


12 

LSHLDI 

NO 

Aft 


13 

RSHLDI 

NO 


1 4 

LSHI 

YES 

/4f 


15 

RSHI 

NO 

en 

Cu bo 

16 

LSHDI 

YES 

e* 

C? pj 

17 

RSHDI 

NO 

Dw 

CV D y 

18 

LSHLR 

NO 


C7 

19 

RSHLR 

NO 

tif 

CP jo 

1 A 

LSBLDR 

NO 


W ps 

cr »f 

IB 

LDR 

NO 

1C 

LSHR 

YES 

o 0 


1 D 

RSHR 

NO 

£» 


IE 

LSHDR 

YES 

& 


IF 

RSHDR 

NO 

'Y 





fr 

91 

2d 

BF 

NO 

e> 



so 

ft 

30 

BT 


ft 

NO 


Ef 






4 ^ 

51 

52 

53 

54 

55 

56 

58 

59 

5 A 

5B 

5C 

5D 

5D2 

5D2 

5D2 

5D4 

5D4 

5D4 

5D4 

51)6 

5 D6 

5D8 

5D8 

51)8 

5 D8 

5 DA 

5 DC 

5 DA 

5DC 

5 DC 

5 DC 

5E 

5F 

6 1 

62 

6 3 

64 

b5 

66 

67 

68 

69 

6 A 

6 U 

6C 

6 D 

6 V 

71 

72 

73 

74 
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B 

NO 

ARI 

YES 

SRI 

YES 

MRI 

NO 

DRI 

YES 

CRI 

YES 

RRI 

NO 

OR I 

NO 

NRI 

NO 

XRI 

NO 

CLRI 

YES 

TMRI 

YES 

BCF 

NO 

BM 

NO 

BN 

NO 

BG 

NO 

BP 

NO 

BO 

NO 

BL 

NO 

BN S 

NO 

BNZ 

NO 

BN E 

NO 

BZ 

NO 

BC 

NO 

BE 

NO 

BS 

NO 

BNP 

NO 

BN L 

NO 

BNO 

NO 

BN M 

NO 

BN N 

NO 

BN G 

NO 

RETURN 

NO 

SIMALE 

NO 

ARH 

YES 

SRH 

YES 

MRH 

NO 

DRli 

YES 

CRH 

YES 

RRH 

NO 

SWR11 

NO 

ORH 

NO 

NRH 

NO 

XRH 

NO 

CLRH 

YES 

TMRH 

YES 

CASE 

NO 

ETC 

MUNG 

ARA 

YES 

SR A 

YES 

MRA 

NO 

DR A 

YES 
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75 

CRA 

76 

RR A 

78 

ORA 

79 

NR A 

7 A 

XR A 

7 B 

CLR A 

7C 

TMRA 

7 F8 

TSA 

7FD 

CALLA 

7 FE 

SINTA 

7 FF 

INTAA 

86 

RRB 

87 

SWR B 

88 

ORB 

89 

NRB 

8 A 

XR B 

SB 

CL R B 

8C 

TMRB 

8 D 

IDLE 

8 E 

CLOCK 

91 

A HR 

92 

SHR 

95 

CHR 

96 

R HR 

97 

SWHR 

98 

OHR 

99 

NHR 

9 A 

X HR 

9B 

CLHR 

9C 

TM HR 

9 DO 

SEMA 

9F0 

S'ZH 

9F1 

SOH 

9F2 

IH 

9F3 

IIH 

9F4 

DTSH 

9F5 

DDTSH 

9F6 

ABSH 

9F7 

NEGH 

9F8 

TSH 

9FA 

SQRTH 

9 FC 

BH 

9 FD 

CALLH 

9 FE 

SINTH 

9FF 

I NT AH 

A6 

RBR 

A7 

SWBR 

A8 

OBR 

A9 

. NBR 

AA 

XBR 

AB 

CL BR 

AC 

TMBR 


YES 

NO 

NO 

NO 

NO 

YES 

Y ES 

YES 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

YES 

¥ ES 

NO 

NO 

YES 

YES 

YES 

NO 

NO 

NO 

NO 

NO 



NO 

NO 

NO 

NO 

YES 

YES 

NO 

NO 

YES 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

NO 

YES 

YES 
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B 1 

AHI 

YES 

B2 

SHI 

YES 

B5 

CHI 

YES 

B6 

RHI 

NO 

B8 

0H1 

NO 

B9 

NUI 

NO 

BA 

XHI 

NO 

BB 

CLHI 

YES 

BC 

TM HI 

YES 

C 1 

AHA 

YES 

C2 

SHA 

YES 

C5 

CHA 

YES 

C6 

RH A 

NO 

C8 

OHA 

NO 

C9 

Nil A 

NO 

CA 

X HA 

NO 

CD 

CLilA 

YES 

CC 

TM HA 

YES 

D 1 

AHH 

YES 

D2 

SHH 

YES 

05 

CHH 

YES 

D6 

RH H 

NO 

D7 

SWHH 

NO 

D8 

OH H 

NO 

D9 

NHH 

NO 

DA 

XHH 

NO 

DB 

CL HH 

YES 

UC 

TMHH 

YES 

E6 

RBI 

NO 

E8 

OBI 

NO 

E9 

NBI 

NO 

EA 

XB1 

NO 

EB 

CLBI 

YES 

EC 

tub i 

YES 

FO 

SCFEA 

YES 

El 

SCFNA 

YES 

E2 

SCBEA 

YES 

F3 

SC BN A 

YES 

F4 

SC FT 

YES 

F5 

SCBT 

YES 

F6 

RCC 

NO 

F8 

OCC 

NO 

F9 

NCC 

NO 

FA 

XCC 

NO 

FB 

CLCC 

YES 

FD 

TR 

NO 

FE 

IN IT 

NO 

FF 

XFER 

NO 
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£££endix_3Aj.. 

— ASCII. 

-IO_ES£DIC_ 

_£QJVErsion_ 



ASCII 

EBCDIC 

GRAPHIC 

ASCII 

EBCDIC 

£BAPHIC 

00 

00 

* NUL 

20 

40 

* SPACE 

0 1 

01 

SOH 

21 

5A 

V 

02 

02 

STX 

22 

7F 

H 

03 

03 

ETX 

23 

7B 

# 

04 

37 

EOT 

24 

5B 

$ 

05 

2D 

ENQ 

25 

6C 

% 

06 

2 E 

ACK 

26 

50 

& 

07 

2 F 

BEL 

27 

7D 

1 

08 

16 

* BS 

28 

4D 

{ 

09 

05 

HI 

29 

5D 

) 

0A 

25 

* LF 

2 A 

5C 

* 

0 B 

OB 

VI 

2B 

4E 

4* 

OC 

OC 

FF 

2C 

6B 

f 

OD 

15 

* CR 

2D 

60 


OE 

OE 

SO 

2E 

4B 

• 

OF 

OF 

SI 

2F 

61 

/ 


10 

10 

DLE 

30 

FO 

0 

11 

1 1 

DC1 

31 

FI 

1 

1 2 

12 

* DEC SZ 

32 

F2 

2 

1 3 

13 

* INCSZ 

33 

F3 

3 

14 

3C 

* TERM 

34 

F4 

4 

15 

3D 

NAK 

35 

F5 

5 

16 

32 

SYR 

36 

F6 

6 

17 

26 

ETB 

37 

F7 

7 

18 

18 

CAN 

38 

F8 

8 

19 

19 

EM 

39 

F9 

9 

1 A 

3 F 

SUB 

3A 

7A 

• 

1 B 

27 

ESC 

3B 

5E 

-* 

1C 

1C 

FS 

3C 

4C 

< 

1 D 

ID 

GS 

3D 

7E 

= 

IE 

IE 

RS 

3E 

6 E 

> 

1 F 

1 F 

VS 

3F 

OF 




40 

4 1 

42 

4 3 

44 

45 

46 

47 

48 

49 

4 A 

4 B 

4C 

4 D 

-4 E 

4 F 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

5A 

58 

5C 

5 D 

5 E 

5 F 


7C a) 

Cl A 

C2 B 

C3 C 

C4 D 

C5 E 

C 6 F 

C7 G 

C8 H 

C9 I 

D1 J 

D2 K 

D3 L 

D4 n 

D5 N 

D6 0 

D7 P 

D8 Q 

D9 R 

E2 S 

E3 T 

E4 U 

E5 V 

E6 W 

E7 X 

E8 Y 

E9 Z 

AD [ 

E0 \ 

BD ] 

71 t 

6 D 
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60 

78 

61 

81 

62 

82 

63 

83 

64 

84 

65 

85 

66 

86 

67 

87 

68 

88 

69 

89 

6A 

91 

6B 

92 

6C 

93 

6D 

94 

6E 

95 

6F 

96 

70 

97 

71 

98 

72 

99 

73 

A2 

74 

A3 

75 

A4 

76 

A5 

77 

A6 

78 

A7 

79 

A8 

7A 

A9 

7B 

8B 

7C 

4F 

7D 

9B 

7E 

59 

7F 

07 


ASCII to EBCDIC 


a 

b 

c 

d 

e 

f 

9 

h 

i 

3 

k 

1 

ra 

n 

o 

P 

9 

r 

s 

t 

u 

V 

w 

X 

y 


z 



} 


DEL 
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ASCII to EBCDIC 


80 

20 

y (CUP) 

AO 

81 

21 

* (CDOWN) 

A1 

82 

22 

(CHOME) 

A2 

83 

23 

v (CFOK) 

A3 

84 

24 

v (CBACK) 

A4 

85 

CD 


A5 

86 

9F 


A6 

87 

77 


A7 

88 

E0 


A8 

89 

9 F 


A9 

8 A 

9F 


AA 

8B 

9 F 


AB 

8C 

9 F 


AC 

8D 

9F 


AD 

8 E 

9 F 


AE 

8 F 

9F 


AF 


43 

□ 

44 


48 

u 

75 

O 

DB 

£ 

51 

V 

4 1 


53 


54 

cz 

55 

O 

58 


62 

-r 

8C 

< 

64 


AE 

> 

5F 



90 

9F 

91 

A1 

92 

61 

93 

9 F 

94 

9F 

95 

9 F 

96 

CD 

97 

9 F 

98 

9F 

99 

61 

9 A 

9F 

9B 

41 

9C 

9F 

9D 

42 

9 E 

9 F 

9 F 

9 F 


BO 

9F 

Bl 

45 

B2 

67 

B3 

76 

B4 

4 A 

B5 

52 

B6 

9F 

B7 

68 

B8 

57 

B9 

56 

BA 

49 

BB 

b 3 

BC 

47 

BD 

BE 

BE 

46 

BF 

69 


n □< 
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CO 

72 

* * 

E0 

* 15 

(CURSOR) 

C 1 

67 

V 

El 

AA 

Of 

C 2 

BF 


E2 

FC 

ft 

C3 

9 F 


E3 

6A 

V 

C 4 

8D 

A 

E4 

BO 

df 

C5 

6 6 

3 

E5 

B1 

€ 

C6 

8E 

$ 

E6 

B2 


C7 

A F 

o 

E7 

FD 


C 8 

ED 

T 

E8 

EC 

JL 

C 9 

8F 

'J' 

E9 

BC 


CA 

80 


EA 

E0 


CB 

9F 


EB 

74 


CC 

9F 


EC 

B3 

X 

CD 

9F 

A 

ED 

B4 


CE 

90 


EE 

B5 


CF 

9C 

St 

EF 

B6 

Cxi 


DO 

BB 

7T 

F0 

B7 

Tr 

D1 

9 F 


FI 

65 


D 2 

9D 


F2 

B8 


D3 

9 E 

2 

F3 

B9 

<r 

D4 

AO 

e 

F4 

BA 

T 

D5 

9F 


F5 

9F 


D6 

70 


F6 

9F 


D7 

9.F 


F7 

9F 


D8 

9 F 


D8 

9F 


D9 

9 F 


0 F9 

68 


DA 

CB 


FA 

* 04 

SCROTUM 

DB 

AB 

L 

FB 

AC 

r 

DC 

73 

=3> 

FC 

4F 

J 

DD 

EE 

t- 

FD 

EF 

H 

DE 

DO 


FE 

CO 

/V 

DF 

A1 

o 

FF 

* 9F 

® t yJCr 
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EBCDIC 

ASCII 

GRAPHIC 

OC 

00 

NULL 

01 

01 

SOU 

02 

02 

SIX 

03 

03 

ETX 

04 


SCROTUM 

05 

09 

HT 

06 

FF 


07 

7 F 

DEL 

08 

FF 


09 

FF 


0A 

FF 


OB 

OB 

VT 

CC 

OC 

FF 

OD 

FF 


OE 

OE 

SO 

OF 

OF 

SI 

10 

10 

DLE 

11 

1 1 

DC 1 

12 

12 

DECS'Z 

13 

13 

INC SZ 

14 

£0 

(CURSOR) 

15 

OD 

CR 

16 

08 

BS 

17 

FF 


18 

18 

CAN 

19 

19 

EM 

1 A 

FF 


IB 

FF 


1C 

1C 

FS 

ID 

ID 

GS 

IE 

1 E 

RS 

IF 

1 F 

US 


EBCDIC 

ASCII 

GRAPHIC 

20 

80 

(CUP) 

21 

81 

(CDOWN) 

22 

82 

(CHOM E) 

23 

83 

(CFOR) 

24 

84 

(CBACK) 

25 

OA 

LF 

26 

17 

ETB 

27 

IB 

ESC 

28 

FF 


29 

FF 


2A 

FF 


2B 

FF 


2C 

FF 


2D 

05 

ENQ 

2E 

06 

ACK 

2F 

07 

BEL 

30 

FF 


31 

FF 


32 

16 

SYN 

33 

FF 


34 

FF 


35 

FF 


36 

FF 


37 

04 

EOT 

38 

FF 


39 

FF 


3A 

FF 


3B 

FF 


3C 

14 

TERM 

3D 

15 

NAK 

3E 

FF 


3F 

1 A 

SUB 
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- EBCDIC 

to ASCII 




EBCDIC 

ASCII 

GRAPHIC 

EBCDIC 

ASCII 

GRAPHIC 

40 

20 

SPACE 

60 

2D 

- 

4 1 

A6 


61 

2F 

/ 

42 

9D 


62 

AB 


43 

AO 


63 

BB 


4 4 

A1 


64 

AD 


45 

B 1 


65 

FI 


46 

BE 


66 

C5 


47 

DC 


67 

Cl 


48 

A2 


68 

B7 


49 

BA 


69 

BE 


4 A 

B4 

£ 

6 A 

E3 


4 B 

2E 

• 

6B 

2C 

9 

4C 

3C 

< 

6C 

25 

% 

4 D 

28 

( 

6D 

5F 


4 E 

2B 

+ 

6E 

3E 

> 

4 F 

EC 

1 

6F 

3F 

7 

50 

26 

& 

70 

D6 


51 

A 5 


71 

5E 


52 

B5 


72 

CO 


53 

A7 


73 

DC 


54 

A8 


74 

EB 


55 

A 9 


75 

A3 


56 

B9 


76 

B3 


57 

B8 


77 

87 


58 

AA 


78 

60 


59 

7 E 


79 

FF 


5 A 

21 

1 

# 

7A 

3A 


5B 

24 

.$ 

7B 

23 

# 

5C 

2A 

* 

7C 

40 

a) 

5D 

29 

) 

7D 

27 

i 

5E 

3B 

9 

7E 

3D 

= 

5 F 

AE 

1 

7F 

22 

ii 
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EBCDIC 

80 

81 

82 

83 

84 
8b 
86 

87 

88 

89 
8 A 
8 B 
8C 
8 D 
8 E 

8 F 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

9 A 
98 
9C 

» 9 D 
9 E 
9 F 
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ascii 

iMAPUIC 

EBCDIC 

ASCII 

CA 


AO 

D4 

61 

d 

A 1 

DF 

62 

b 

A2 

73 

63 

c 

A3 

74 

64 

d 

A4 

75 

65 

e 

A 5 

76 

66 

f 

A6 

77 

6 7 

9 

A7 

7d 

6 8 

h 

A8 

79 

69 

i 

A9 

7 A 

FF 


AA 

El 

7B 


AB 

DB 

AC 


AC 

FB 

C4 


AD 

50 

C 6 


AE 

AE 

C9 


AF 

C7 

CE 


BO 

E4 

6 A 

j 

B1 

E5 

6 B 

k 

B2 

E6 

6C 

1 

B3 

EC 

6 D 

m 

B4 

ED 

6E 

n 

B5 

EE 

6 F 

o 

B6 

EF 

70 

P 

B7 

F0 

71 

q 

B8 

F2 

72 

r 

B9 

F3 

FF 


BA 

F4 

7D 


BB 

DO 

CF 


BC 

E9 



BD 

5D 

D3 


BE 

BD 

FF 


BF 

C2 


GHAPHIC 


u 

v 

w 

X 

y 

z 


n* co 



EBCDIC 


CO 

Cl 

C 2 
C3 
C4 
C 5 
C6 
C7 
C8 

c y 

CA 

CB 

CC 

CD 

CE 

CF 


DO 
D 1 

D2 

D3 

D4 

D5 

D6 

D7 

D8 

D9 

DA 

DB 

DC 

DD 

D£ 

DF 


ASCII 

FE 

41 

42 

43 

44 

45 

46 
4 7 

48 

49 
FF 
96 
FF 
FF 
FF 
FF 

DE 
4 A 
4 B 
4C 
4 D 
4 E 
4 F 

50 

51 

52 
FF 
A4 
FF 
FF 
FF 
FF 


GRAPHIC 


A 

B 

C 

D 

E 

F 

G 

II 

G 


J 

K 

L 

M 

N 

0 

P 

0. 

R 


EBCDIC 

EO 

El 

E2 

E3 

E4 

E5 

E6 

E7 

E8 

E9 

EA 

EB 

EC 

ED 

EE 

EF 

FO 

FI 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

FA 

FB 

FC 

FD 

FE 

FF 


ASCI I 
5C 
FF 

53 

54 

55 
5o 

57 

58 

59 
5A 
FF 
FF 
E8 
C8 
DD 
FD 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 
FF 
FF 
E2 
E7 
FF 
FF 


GRAPHIC 







We would line to thank. the following people toe their 
invaluable nelp in the creation of the system described in 
this document: 

Russell Wayne Burns 

who designed and implemented the FUDD debugging package. 
William Benjamin Rothman 

who read this nonsense relentlessly, proofing and 
suggesting changes, some of which were inadvertantly 
included. 
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A survey of the vast experimental literature on the effects 
of computing system design is likely to convince the most 
dispassionate observer that the possibility of de-kludging 
is improbable. 

--adapted frem I. Steele Russell, 1971 


